Skip to main content
This guide covers the most common API workflows. For the full reference, see the OpenAPI spec.

Authentication

All API requests require a Bearer token:

Common Flows

1. List your connected accounts

Response:

2. Create and publish a post

3. Schedule a post for later

Use ISO 8601 format with UTC timezone.

4. Upload media and attach to a post

First, get an upload URL:
Response:
Upload the file to the upload_url, then create the post with media_ids:

5. Connect a new platform via OAuth

Response:
Redirect the user to authorization_url. After they complete OAuth, poll for status:
When status is completed, the account is connected.

6. Handle rate limits

If you get a 429 response:

Error Codes

Example 422 response:
Last modified on February 21, 2026