Skip to main content
POST
Create a draft

Authorizations

Authorization
string
header
required

An API key from Settings, API & MCP: pm_live_...

Headers

Idempotency-Key
string

Makes a retry safe: the same key within 24 hours answers with the first request's result. Up to 255 printable characters.

Required string length: 1 - 255

Body

application/json

A draft: saved, never sent until you post it.

content
string
Maximum string length: 63206
platforms
enum<string>[]
Maximum array length: 12

A network PostMesh posts to.

Available options:
twitter,
youtube,
instagram,
tiktok,
threads,
facebook,
linkedin,
reddit,
bluesky,
mastodon,
telegram,
discord
scheduled_at
string<date-time> | null

A planned time. A draft is never sent on its own.

metadata
object

Composer fields (captions, media, settings) kept with the draft.

label_ids
string<uuid>[]
Maximum array length: 10

Response

Saved.

draft
object
required

A saved draft.