API overview, access and pricing
The Postbean API lets you build publishing into your own software. It runs on the same official platform integrations the app uses, so anything you publish through it is subject to the same platform rules.
Getting access
Section titled “Getting access”- Open Settings → Developers (
/panel/settings/developers). - Turn on the developer add-on — $5/mo on top of your plan.
- Click Create API key, pick the permissions it carries, and copy the token. It is shown once.
An active Postbean subscription is required.
Authentication
Section titled “Authentication”Send the token as a bearer token:
Authorization: Bearer YOUR_TOKENA key belongs to one workspace. To work across workspaces, issue a key per workspace.
What it covers
Section titled “What it covers”| Area | What you can do |
|---|---|
| Accounts | List connected accounts, refresh one, read TikTok’s creator options |
| Media | Request an upload URL, upload a file, attach it to a post |
| Posts | Create, read, update and delete; drafts and scheduled posts |
| Publishing | Publish now, retry a post or a single network, cancel |
| Per network | Reschedule, stop or remove one network from a post |
| AI | Generate captions and campaigns, read your credit balance |
| Sources | Register content sources and poll them |
Every endpoint is guarded by a scope, so a key without posts:publish cannot publish however it is called.
Permissions
Section titled “Permissions”| Permission | What it allows |
|---|---|
accounts:read | View connected accounts |
posts:read | Read posts and renders |
drafts:write | Create and edit drafts |
posts:publish | Publish to networks |
posts:delete | Delete posts |
credits:read | View credits |
ai:generate | Generate content with AI |
campaigns:generate | Generate campaigns |
They are fixed when the key is created. Needing a new permission means issuing a new key — which is deliberate, because it makes widening a key’s reach a decision rather than an accident.
Limits
Section titled “Limits”Uploads follow the same caps as the app: 100 MB per video, 8 MB per image. Platform posting quotas are the networks’ own — see Platform limits.
Where to go next
Section titled “Where to go next”- Connect your AI agent with MCP — the same capabilities, in plain language, from Claude or Cursor.
/mcp/skill.md— the machine-readable reference.- Contact us for questions and bug reports.