Docs
API referenceDashboardGet API key

Get a post

One post by id, with its status, publish time, link once published, and failure when the last publish failed.

Try it

GET
/v1/posts/{id}

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 post's id

Responses

application/json

application/json

application/json

application/json

application/json

Create a postPOST

Saves a draft; with scheduledAt it's scheduled, with publishNow Postel publishes it within a minute (the response comes back at once with status scheduled; post.published or post.failed events say how it went). Scheduling and publishing need a paid plan; drafts work on every plan.

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).