Skip to main content
POST

Authorizations

Authorization
string
header
required

Your organization's API key, from Settings → API. Authorization: Bearer crl_sk_live_…

Path Parameters

id
string<uuid>
required

Body

application/json
mode
enum<string>
default:schedule

now posts immediately, schedule posts at scheduled_for, queue takes the creator's next free cadence slot.

Available options:
now,
schedule,
queue
scheduled_for
string

"HH:mm" for mode=schedule.

Response

The post, now scheduled and handed off.

object
enum<string>
required
Available options:
clip
id
string<uuid>
required
status
enum<string>
required
Available options:
pending_review,
approved,
scheduled,
published,
failed,
rejected
asset_ids
string<uuid>[]
required
title
string
format
enum<string>
Available options:
photo,
video,
carousel
ratio
string
caption
string
hashtags
string[]
channels
string[]
scheduled_for
string
published_at
string
created_at
number
duration_sec
number
account_id
string<uuid>
error
string
channel_posts
object[]

Per-platform publish state, filled in as each platform confirms.