Docs
API referenceDashboardGet API key

Publish a draft now

Needs a paid plan. Postel publishes the draft within a minute; the response comes back at once (202, status scheduled) and post.published or post.failed events say how it went. Publishing never runs inside the request, so a client that times out and retries can't post twice. Refused when the workspace needs approval (409 approval_required): schedule the post instead.

Try it

POST
/v1/posts/{id}/publish

Authorization

bearerAuth
AuthorizationBearer <token>

A Postel API key, Authorization: Bearer pstl_…. Create one in Postel under Settings → API & MCP; it acts for the workspace it was made in.

In: header

Path parameters

id*string

The draft's id

Responses

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

Schedule a draftPOST

Schedules a draft for scheduledAt. Needs a paid plan and a connected channel. When the workspace needs approval, the post waits for an owner or admin (status pending_approval, with a message). Only drafts can be scheduled: a scheduled post keeps its slot (409 not_a_draft), and two posts can't share the exact minute on one network (409 time_taken).

Write a post in your voicePOST

Postel writes a post from your prompt in your own voice and saves it as a draft. Uses 1 AI credit (none when the workspace uses its own AI key); works on every plan. Takes 5 to 30 seconds, so give the request a 60-second timeout. Up to 3 at a time per workspace; a fourth gets 429. Send an Idempotency-Key header so a retried step returns the first draft instead of writing (and charging) again.