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.
publish_type	regular \| short \| story	Effective publish mode.
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.
title	string \| null	Platform-specific title for the root post.
link	string \| null	Platform-specific link for the root post.
terms_and_conditions	string \| null	Google Business offer terms.
coupon_code	string \| null	Google Business offer coupon code.
start_date	string \| null	Google Business event/offer start datetime.
end_date	string \| null	Google Business event/offer end datetime.
cta	string \| null	Google Business CTA.
topic_type	string \| null	Google Business topic type.
privacy_status	string \| null	YouTube/TikTok privacy status.
allow_comments	boolean \| null	TikTok comment toggle.
allow_duet	boolean \| null	TikTok duet toggle.
allow_stitch	boolean \| null	TikTok stitch toggle.
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.
title	string \| null	Platform-specific subpost title.
link	string \| null	Platform-specific subpost link.
terms_and_conditions	string \| null	Google Business offer terms.
coupon_code	string \| null	Google Business offer coupon code.
start_date	string \| null	Google Business event/offer start datetime.
end_date	string \| null	Google Business event/offer end datetime.
cta	string \| null	Google Business CTA.

`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.
board_id	string \| null	Pinterest board ID for this account target.

`Account customization`

Field	Type	Description
id	string	Social account identifier being customized.
platform	string	Platform name.
board_id	string \| null	Pinterest board ID for this account customization.
text	string \| null	Custom text for that account.
media	Media[]	Custom media for that account.
subposts	Subpost[]	Custom subposts for that account.
title	string \| null	Platform-specific custom title.
link	string \| null	Platform-specific custom link.
terms_and_conditions	string \| null	Google Business offer terms.
coupon_code	string \| null	Google Business offer coupon code.
start_date	string \| null	Google Business event/offer start datetime.
end_date	string \| null	Google Business event/offer end datetime.
cta	string \| null	Google Business CTA.

`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
`telegram`	Telegram

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