List the social accounts connected to your Post for Me workspace. Optionally filter by platform (instagram, tiktok, x, ...). Returns account ids you pass to create_post via social_accounts.

Get a single connected social account by id, including platform, username and status.

Manually create/connect a social account by supplying its platform and credentials/tokens. For the standard interactive OAuth flow, prefer create_auth_url instead.

Update a connected social account (e.g. refresh stored credentials or metadata).

Start the OAuth connect flow for a platform. Returns a URL — open it in a browser to authorize the account; once approved, it appears in list_social_accounts. Use this to connect a new Instagram/TikTok/X/etc.

Disconnect a social account — revokes Post for Me's access. The account stops being usable for posting until reconnected via create_auth_url.

ANALYTICS: list the recent feed for a connected account — the posts on that platform, optionally with engagement metrics (likes, comments, views, etc.). Use this to pull performance data for a given account.

Create a social post across one or more connected accounts/platforms. This is the primary publishing tool. Set scheduled_at (ISO-8601) to schedule, status='draft' to save without publishing, or omit both to publish immediately. Use platform_configurations for per-network tweaks. For common cases the shortcuts publish_now / schedule_post / create_draft are simpler.

Shortcut: publish a post immediately to the given accounts. Equivalent to create_post with no scheduled_at and status='published'.

Shortcut: schedule a post for a future time. Equivalent to create_post with scheduled_at set and status='scheduled'.

Shortcut: save a post as a draft without publishing or scheduling it. Equivalent to create_post with status='draft'.

Get a single social post by id, including its status, caption, media and target accounts.

List social posts, optionally filtered by status (draft/scheduled/published/error) and paginated. Use this to review queued, scheduled or published content.

Update an existing post by id — change the caption, media, target accounts, schedule or platform_configurations. Works on drafts and scheduled posts.

Shortcut: move a scheduled post to a new time. Equivalent to update_post with only scheduled_at set.

Delete a social post by id (drafts, scheduled or published records).

ANALYTICS: list publishing results across posts — each row is the outcome of one post on one platform (success/error, native post id & URL). Filter by social_post_id to see how a specific post fared on every target account.

Get a single post result by id — the detailed outcome of one post on one platform, including the native post URL/id and any error message.

Generate a preview of how a post would appear on each target platform, without publishing it. Pass the same caption/media/social_accounts/platform_configurations you'd send to create_post. Great for a confirm-before-publish step.

Get a signed URL to upload a media file. Returns an upload_url (PUT your bytes there) and the media URL to reference in a post. Prefer upload_media if you want the upload done for you in one step.

One-step media upload: provide a local file path OR a public URL, and this generates a signed URL, uploads the bytes, and returns { media_url } ready to drop into create_post/publish_now/schedule_post media. Use this whenever you need to attach an image or video.

List the webhooks configured in your workspace.

Get a single webhook by id.

Create a webhook that POSTs to your HTTPS endpoint when the chosen events occur (e.g. post published, post errored). Subscribe to specific event types or all of them.

Update a webhook's URL or subscribed event types.

Delete a webhook by id.

Call any Post for Me REST endpoint directly (escape hatch for full API coverage). Provide the HTTP method and the FULL path INCLUDING the version segment (e.g. '/v1/social-posts' or '/v1/social-accounts/acc_xxx'), plus optional query params and JSON body. Use this only when no dedicated tool exists. Auth, retries and rate-limiting are handled for you. Reference: https://api.postforme.dev/docs