Skip to main content
POST
Create a post

Authorizations

Authorization
string
header
required

A pb_live_ API key

Headers

Idempotency-Key
string

Repeat a request with the same key to get the first post back instead of a new one.

Maximum string length: 255

Body

application/json
body
string

The post text, for a single post.

thread
string[]

Several posts to publish as a thread, in order. Takes precedence over body.

channel_ids
string<uuid>[]

Channels to publish to, from GET /channels.

channel_bodies
object

Text for particular channels instead of body, keyed by channel id. Each is a single post.

scheduled_at
string<date-time> | null

When to publish: ISO 8601 with Z or an offset (2026-10-01T09:00:00+01:00). Omit or null to save a draft.

schedule_in_minutes
number

Publish this many minutes from now, on the server's clock. Instead of scheduled_at.

media_ids
string<uuid>[]

Files from GET /media to attach, in order.

media_urls
string<uri>[]

Public https links to images or a video, attached after media_ids. Each is downloaded into the media library (up to 10 per request, 200 MB each).

Maximum array length: 10
youtube
object
idempotency_key
string

Same as the Idempotency-Key header.

Maximum string length: 255

Response

A repeat of an earlier request (same idempotency key)

post
object