Skip to main content
POST
Publish or schedule a post

Authorizations

Authorization
string
header
required

Agent token (alt_…) or OAuth access token; bound to one agent

Body

application/json
account_ids
string[]
required

Social accounts to post to (sac_…), at most one per network

Required array length: 1 - 10 elements
Required string length: 1 - 100
content
string

Post text. Optional when media is attached or every account has its own content

Maximum string length: 25000
media_urls
string<uri>[]

Public https URLs of images or videos; upload local files with create_social_media_upload first

Maximum array length: 10
Maximum string length: 2048
scheduled_for
string<date-time>

ISO 8601 time to publish at; omit to publish now (within about a minute)

overrides
object[]

Per-account text and network options

Maximum array length: 10
idempotency_key
string

Repeat a request with the same key to get the same post instead of a second one

Required string length: 1 - 200

Response

Accepted post

post
object
required