Request a signed upload URL for a media file (image/video). Returns upload_url (PUT your file there) and media_url (use in post). Media assets are temporary: deleted when the post is published, after 24h if unused, or when the post is deleted.

Get a paginated list of social posts. Filter by platform, status, external ID, or social account ID. Multiple filter values use OR logic.

Create and schedule (or publish immediately) a social media post across one or more accounts. Omit scheduled_at to post instantly. Use platform_configurations for per-platform overrides and account_configurations for per-account overrides. The most specific override wins.

Get a single social post by its ID.

Update an existing social post (replaces the entire post definition). Use the same schema as create — all fields are re-set.

Delete a social post by its ID.

Get a paginated list of social post results. Filter by post IDs, platform(s), or social account IDs (all use OR logic). Results show success/failure, errors, platform URL, and per-platform data.

Get a single social post result by its ID. Includes success/failure, errors, platform_data (ID + URL), and media.

Get a paginated list of connected social accounts. Filter by platform, username, external ID, account ID, or connection status. All filters use OR logic.

Create a social account directly (upsert by platform + user_id). If an account with the same platform and user_id already exists, it is updated. Use this when you have OAuth tokens from your own auth flow.

Get a single social account by its ID.

Update a social account's username or external_id.

Generate an OAuth URL to connect a user's social media account. Redirect the user to this URL; they'll be redirected back after auth. For Quickstart projects using Post for Me system credentials, redirect_url_override is not accepted — configure it in the dashboard instead. Include 'feeds' in permissions to later fetch the account feed and metrics.

Disconnect a social account — removes all auth tokens and marks it as disconnected. The account record is kept and can be retrieved and reconnected by the owner.

Get the social media feed for a connected account — every post made under that account, including posts not created through Post for Me. Pass expand=['metrics'] to include analytics (views, likes, follows, etc.). Requires the account to have been connected with 'feeds' permission. Supported: Instagram, Facebook, TikTok, TikTok Business, YouTube, Threads, X, Bluesky, Pinterest, LinkedIn.

Get a paginated list of webhooks. Filter by URL, event type, or webhook ID.

Create a webhook to receive event notifications. Returns a secret in the response — store it to verify incoming requests via the 'Post-For-Me-Webhook-Secret' header. Available events: social.post.created, social.post.updated, social.post.deleted, social.post.result.created, social.account.created, social.account.updated.

Get a single webhook by its ID.

Update a webhook's URL and/or subscribed event types.

Delete a webhook by its ID.

Generate a preview of what a post will look like for each specified account. You can preview non-connected accounts by specifying a placeholder ID. Returns per-account preview objects with resolved caption, media, platform, and configuration.