Skip to main content
New to Corsair? See API access, authentication, and error handling.

Accounts

list

accounts.list List connected social accounts (LinkedIn, X, Threads, Bluesky, Facebook Pages, Instagram, TikTok, YouTube, Pinterest) with status, capabilities and media requirements. Their ids are the targets for posts.create. Risk: read
Input: empty object Output

Analytics

get

analytics.get Per-account and per-post views, likes, comments, shares and saves over the last 7, 30 or 90 days, including posts made outside PostOnce, with each post compared to its account’s median views. Risk: read
Input Output

Drafts

create

drafts.create Save text, media and intended accounts as a draft without publishing or scheduling it. Risk: write
Input
Output

get

drafts.get Get one draft. Risk: read
Input Output

list

drafts.list List unscheduled drafts, newest first. Page with after = meta.next_after and after_id = meta.next_after_id. Risk: read
Input Output

update

drafts.update Edit, archive, restore or mark a draft ready. Pass the draft’s current updated_at as expected_updated_at; a stale value gets a 409. Risk: write
Input
Output

Media

createUpload

media.createUpload Get a signed URL to upload an image or video to, and a media_id. After the file is PUT to the URL, media.get gives the public URL that posts and drafts accept. Risk: write
Input Output

get

media.get Turn a media_id into the uploaded file’s public URL. Risk: read
Input Output

Posts

cancel

posts.cancel Cancel a scheduled or still-pending post. The post record is kept with status cancelled; content already published on a network stays live. Risk: destructive · Irreversible
Input Output

create

posts.create Create one post for one or more connected accounts, with text and media URLs. Without publish_at it publishes immediately and cannot be recalled once live; with publish_at it is scheduled. An idempotencyKey makes a retry return the original post. Risk: destructive
Input
Output

get

posts.get Get one post with its per-account delivery state: status, platform post URL and any platform error. Risk: read
Input Output

getAnalytics

posts.getAnalytics Views, likes, comments, shares and saves for each published copy of one post (TikTok, Instagram, YouTube and Facebook). Cached for up to an hour. Risk: read
Input Output

list

posts.list List the profile’s posts, newest first, including dashboard and workflow posts. Page with after = meta.next_cursor. Risk: read
Input Output

publish

posts.publish Publish a scheduled post right now. It goes live on every target and cannot be recalled. Risk: destructive
Input Output

retryTarget

posts.retryTarget Retry one failed destination of a post (targetId from the post’s targets). Published destinations are not posted again. Risk: destructive
Input Output

update

posts.update Change a scheduled post before it runs: text, accounts, media or publish time. Only the fields sent change. Risk: write
Input
Output

Webhooks

create

webhooks.create Register an HTTPS endpoint for signed post.published, post.partially_published and post.failed events (up to 5). The reply is the only time the signing secret is shown. Risk: write
Input Output

delete

webhooks.delete Delete a webhook endpoint and its delivery log. Risk: destructive · Irreversible
Input Output

get

webhooks.get Get one registered webhook endpoint. Risk: read
Input Output

list

webhooks.list List registered webhook endpoints (signing secrets are not returned). Risk: read
Input: empty object Output

Workflows

create

workflows.create Create a cross-posting workflow. While active, PostOnce publishes every new post from the source account to the target accounts automatically. Risk: destructive
Input
Output

delete

workflows.delete Delete a cross-posting workflow and its queued items. Risk: destructive · Irreversible
Input Output

get

workflows.get Get one cross-posting workflow. Risk: read
Input Output

list

workflows.list List cross-posting workflows: each copies new posts from a source account to target accounts. Risk: read
Input: empty object Output

update

workflows.update Change a cross-posting workflow: name, accounts, filters or is_active. Turning it on or adding targets makes PostOnce publish future posts to them automatically. Risk: destructive
Input
Output