Skip to main content
POST
Create posts

Authorizations

Authorization
string
header
required

User API token from Settings → Public API. Access is restricted by scopes and workspace selection.

Headers

idempotency-key
string
required
Idempotency-Key
string

Repeat a create safely for 24 hours: the same key and body replays the first response; the same key with a different body returns 409 idempotency_key_reused.

Path Parameters

Body

application/json
type
enum<string>
required
Available options:
draft,
schedule,
now
Example:

"schedule"

Convert eligible links to tracked short links.

tags
object[]
required
posts
object[]
required
order
string

Client-defined ordering value.

republish
boolean
default:false

Allow a previously published post to be published again.

autoSchedule
boolean
default:false

Pick the next open slot from each connected account posting schedule. Scheduled and immediate posts are queued for that slot; drafts keep their type and only take the date.

autoScheduleOptions
object
date
string

UTC publish time. Required unless autoSchedule is true.

Example:

"2026-09-01T09:00:00.000Z"

repeat
object
recycle
object

Response

postId
string
required
Example:

"clz8v2f6r0001k9p8t5m3w7q1"

integration
string
required

The connected account ID used to create the post.

Example:

"clz8tq4ka0001m8p7y6n5r3d2"

approvalStatus
enum<string>
required

Approval state after creation. PENDING posts remain drafts until approved.

Available options:
DRAFT,
PENDING,
APPROVED
externalId
string | null
Example:

"rbdp_123"

Last modified on October 3, 2026