Skip to main content
The PostlyBee Public API lets your application publish content through the social accounts already connected to a PostlyBee workspace. Use it for internal tools, workflow automation, content pipelines, or product integrations.
New here? Follow the Quickstart to authenticate, list connected accounts, and schedule your first post.

​
Start here

Quickstart

Make your first authenticated request and schedule a post.

Authentication

Send your workspace API key as a Bearer token.

API reference

Explore every endpoint with an interactive playground.

​
Base URL

All REST endpoints use the following production origin:
Version 1 endpoints begin with /public/v1. PostlyBee uses HTTPS only in production.

​
What you can build

Publishing workflows

Create drafts, schedule posts, publish immediately, or build threads for connected accounts.

Media pipelines

Upload images and video files before attaching them to a post.

Account discovery

List connected social accounts and select the correct destination by ID.

Agent integrations

Connect compatible AI clients through PostlyBee’s OAuth-enabled MCP server.

​
Request flow

Most publishing integrations follow the same sequence:
  1. Read the API key from a secure secret store.
  2. List connected accounts and select an account ID.
  3. Upload any media and keep the returned media ID and URL.
  4. Create a draft, scheduled post, or immediate post.
  5. Query the post later to inspect its state and publication URL.
API keys grant access to a workspace. Never expose them in browser code, public repositories, query strings, or client-side logs.

​
Rate limits

Posts and upload endpoints are limited to 100 requests per workspace in a one-hour window. Other public endpoints are currently not throttled by this limit. See Rate limits for response headers and retry behavior.
Last modified on August 26, 2026