Skip to main content
Version: 1.66.3

PostBoost API

The PostBoost REST API lets you publish, schedule, and analyze social media posts on every supported network from a single integration. No OAuth apps to maintain — PostBoost handles platform authorization for you.

Base URL​

All workspace-scoped endpoints are prefixed with /{workspaceUuid}. Panel/admin endpoints are prefixed with /panel.

Plan access​

Every workspace-scoped endpoint returns 403 when the workspace's plan does not include API access (capability api).

Dates and times​

Post dates and times (date, time, accounts_schedule) are read in the request's timezone when one is given, otherwise in the workspace timezone.

Idempotent requests​

Send an Idempotency-Key header (any unique string, for example a UUID) with a POST. Repeating the request with the same key within 24 hours returns the stored response with Idempotent-Replayed: true and creates nothing new. Reusing a key with a different body returns 422; a request still in progress with the same key returns 409. 5xx and 429 responses are not stored, so they can be retried with the same key.

Guardrails for automated clients​

Create and update requests are checked before anything is written: a post whose content matches one created for the same account in the last 24 hours returns 409 (code: duplicate_post, override with allow_duplicate: true), scheduling past an account's daily cap returns 429 (code: account_daily_cap_reached), and scheduling to an account that must be reconnected returns 422 (code: account_unauthorized or account_token_missing). Use POST /{workspaceUuid}/posts/validate for a dry run and GET /{workspaceUuid}/activity to review what API clients did.

Authentication​

All requests require a Bearer token in the Authorization header. Generate tokens in your PostBoost dashboard under Settings → Access Tokens.

Authorization: Bearer YOUR_API_TOKEN

Authentication​

Generate API tokens in your PostBoost dashboard under Settings → Access Tokens. Include the token in every request:

Authorization: Bearer YOUR_API_TOKEN

Security Scheme Type:

http

HTTP Authorization Scheme:

bearer

Contact

PostBoost Support: [email protected]

URL: https://postboost.co

License

Commercial