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 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

Pull 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.

​
Prefer an AI assistant?

Connect an MCP client

PublishBuddy also hosts an MCP server. Point Claude Code, Cursor, VS Code, or Windsurf at it with the same API token and let the assistant read analytics, draft posts, and schedule them for you.

​
API at a glance

Base URL: https://api.publishbuddy.com/v1 Auth: Authorization: Bearer <your-token> on every request Plans: Pro and Business (see Plans) Format: JSON in, JSON out (media is uploaded by URL or as multipart/form-data) 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 key in the API Keys section. Store it somewhere safe. You 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: hello@publishbuddy.com.

Plans and limits

Which plans include the API, how requests are throttled, and the daily post creation cap.