Skip to main content
The PublishBuddy API lets you build automations, integrations, and custom tooling on top of the same platform that powers PublishBuddy. Use it to schedule posts to Instagram, Facebook, TikTok, YouTube, LinkedIn, X, Pinterest and more, upload media, read analytics, and manage your team’s social profiles — all from your own code.

Get an API token

Sign in to the dashboard and create an API Key from User Settings → Login & Security.

Quickstart

Make your first authenticated request and publish a post in under five minutes.

API reference

Every endpoint, request shape, and response example — generated from our OpenAPI spec.

Core concepts

Learn how workspaces, profiles, posts, and media fit together.

​
What you can build

Scheduled publishing

Pipe content from your CMS, a spreadsheet, or an internal tool straight into a publishing queue.

Bulk uploads

Move thousands of assets into the media library and organise them with folders.

Analytics warehouses

Stream profile, post, and best-time metrics into your data warehouse for BI dashboards.

Internal tooling

Build approval workflows, content governance dashboards, and agency client portals.

​
API at a glance

Base URL — https://api.publishbuddy.com/v1 Auth — Authorization: Bearer <your-token> on every request Format — JSON in, JSON out (media is uploaded directly to storage via pre-signed URLs) Versioning — URL-based; the current stable version is v1

​
Where to start

1

Generate an API token

Open app.publishbuddy.com, go to User Settings → Login & Security, and create a token. Store it somewhere safe — you’ll only see the value once. See Authentication for the full walkthrough.
2

List your workspaces

Every resource in PublishBuddy belongs to a workspace. Your token’s first request should be GET /workspaces to discover the workspace IDs you have access to.
3

Pick a guide

Jump into the Quickstart for a hands-on tour, or browse the How-to guides for specific recipes.

​
Get help

Email support

Questions, bug reports, or integration help: support@publishbuddy.com.

Status page

Real-time uptime for the API and publishing workers.