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
data full type
data full type
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
data full type
data full type
Drafts
create
drafts.create
Save text, media and intended accounts as a draft without publishing or scheduling it.
Risk: write
media full type
media full type
data full type
data full type
get
drafts.get
Get one draft.
Risk: read
data full type
data full type
list
drafts.list
List unscheduled drafts, newest first. Page with after = meta.next_after and after_id = meta.next_after_id.
Risk: read
data full type
data full type
meta full type
meta full type
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
media full type
media full type
data full type
data full type
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
data full type
data full type
get
media.get
Turn a media_id into the uploaded file’s public URL.
Risk: read
data full type
data full type
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
data full type
data full type
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
targets full type
targets full type
media full type
media full type
data full type
data full type
get
posts.get
Get one post with its per-account delivery state: status, platform post URL and any platform error.
Risk: read
data full type
data full type
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
data full type
data full type
list
posts.list
List the profile’s posts, newest first, including dashboard and workflow posts. Page with after = meta.next_cursor.
Risk: read
data full type
data full type
meta full type
meta full type
publish
posts.publish
Publish a scheduled post right now. It goes live on every target and cannot be recalled.
Risk: destructive
data full type
data full type
retryTarget
posts.retryTarget
Retry one failed destination of a post (targetId from the post’s targets). Published destinations are not posted again.
Risk: destructive
data full type
data full type
update
posts.update
Change a scheduled post before it runs: text, accounts, media or publish time. Only the fields sent change.
Risk: write
targets full type
targets full type
media full type
media full type
data full type
data full type
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
data full type
data full type
delete
webhooks.delete
Delete a webhook endpoint and its delivery log.
Risk: destructive · Irreversible
data full type
data full type
get
webhooks.get
Get one registered webhook endpoint.
Risk: read
data full type
data full type
list
webhooks.list
List registered webhook endpoints (signing secrets are not returned).
Risk: read
data full type
data full type
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
settings full type
settings full type
data full type
data full type
delete
workflows.delete
Delete a cross-posting workflow and its queued items.
Risk: destructive · Irreversible
data full type
data full type
get
workflows.get
Get one cross-posting workflow.
Risk: read
data full type
data full type
list
workflows.list
List cross-posting workflows: each copies new posts from a source account to target accounts.
Risk: read
data full type
data full type
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
settings full type
settings full type
data full type
data full type