Skip to main content
POST
Bulk-enqueue N posts for one account, spread over time.

Authorizations

Authorization
string
header
required

The access_token from the exchange endpoint.

Headers

Idempotency-Key
string

Dedupes a post run; a duplicate key returns the original run (200).

Body

application/json
account_username
string
required
Minimum string length: 1
items
object[]
required
Required array length: 1 - 200 elements
type
enum<string>
default:post
Available options:
post
device_udid
string
cadence
object

Spread for a batch. "now" = immediate; "custom" repeats every intervalHours.

start_at
string<date-time>

Spread anchor; defaults to now.

disposition
enum<string>
default:post_now

Batch-level default.

Available options:
draft,
post_now

Response

Idempotent replay — uploads already staged are returned, not re-enqueued.

schema
string
required
Allowed value: "1.0"
batch
object
required
runs
object[]
required