Skip to main content
These are the core objects you will work with most often when using the PostOnce Public API.

Account

Represents a connected social account owned by the API key profile.
id is the stable identifier you reuse when creating posts and workflows.

Media

Represents uploaded or referenced media attached to a post.
Upload endpoints return a media_id for storage lookups. Post creation currently accepts URL-based media objects.

Post

A Post is the main aggregate resource in the API. One public post can target multiple connected accounts.

Post status

Aggregate post status is derived from the per-target rows:
  • queued
  • scheduled
  • processing
  • published
  • partial
  • failed
  • cancelled

Workflow

A Workflow maps one source account to one or more target accounts.
derived_status is a workflow-specific status, not the same as aggregate post status.