Post object

`Post`

The post object is returned by the posts endpoints and by slot-assignment responses that schedule draft posts.

Request bodies use IDs for media, accounts, and labels. Responses return hydrated objects for those fields.

Field	Type	Description
id	string	Unique post identifier.
status	draft \| scheduled \| publishing \| published \| failed	Publication status.
text	string \| null	Root post text.
media	Media[]	Ordered media items attached to the root post.
subposts	Subpost[]	Ordered subposts, such as thread replies.
accounts	Account[]	Target social accounts.
account_customizations	AccountCustomization[]	Per-account text and media overrides.
labels	Label[]	Labels attached to the post.
scheduled_at	string \| null	Scheduled publishing datetime in ISO 8601 format.
published_at	string \| null	Earliest publish datetime across platforms in ISO 8601 format.
slot_id	string \| null	Scheduling slot identifier when the post is attached to a plan slot.
approval	Approval	Approval workflow state.
notes	string \| null	Internal notes for the post.
short_link_enabled	boolean	Whether short-link generation is enabled.
created_at	string	Creation datetime in ISO 8601 format.
updated_at	string	Last update datetime in ISO 8601 format.

`Media`

Field	Type	Description
id	string	Media record identifier.
type	image \| gif \| video	Media type.
url	string	Signed S3 URL for the media file. URLs expire after 24 hours.
alt_text	string \| null	Accessibility alt text when available.
thumbnail_url	string \| null	Signed S3 URL for a thumbnail when one exists. URLs expire after 24 hours.

`Subpost`

Field	Type	Description
text	string \| null	Subpost text.
media	Media[]	Media attached to the subpost.
published_at	string \| null	Published datetime for this subpost in ISO 8601 format.
condition	Condition \| null	Publish condition when one is configured.

`Condition`

Field	Type	Description
type	string	Condition type.
value	string \| null	Condition value when the type requires one.

`Account`

Field	Type	Description
id	string	Social account identifier.
platform	string	Platform name from the supported platform list.

`Account customization`

Field	Type	Description
id	string	Social account identifier being customized.
platform	string	Platform name.
text	string \| null	Custom text for that account.
media	Media[]	Custom media for that account.
subposts	Subpost[]	Custom subposts for that account.

`Approval`

Field	Type	Description
status	approved \| pending \| not_required	Approval workflow status.
is_approved	boolean	True when status is approved or not_required.
approved_at	string \| null	Approval datetime in ISO 8601 format when available.

Platform values

Value	Platform
`twitter/x`	X
`facebook`	Facebook
`instagram`	Instagram
`linkedin`	LinkedIn
`youtube`	YouTube
`google_business`	Google Business
`tiktok`	TikTok
`threads`	Threads
`pinterest`	Pinterest
`discord`	Discord

Status values

Status	Description
`draft`	Post has not been scheduled yet.
`scheduled`	Post is scheduled for future publishing.
`publishing`	Publishing is in progress.
`published`	Post has been published successfully.
`failed`	Publishing failed.

Get started Endpoints