Schedule a draft

POST 
/posts/:id/schedule

Publish or schedule a DRAFT (a post created with draft: true). Provide scheduled_for to schedule it for a future time, or publish_now: true to publish immediately. Optionally pass account_ids to set or override which accounts it posts to (defaults to the accounts saved on the draft).

This is the final step of the review workflow: create a draft → review it (GET /posts?status=draft) → schedule it. Only works on drafts — the endpoint returns 409 if the post is not a draft (to re-time an already-scheduled post, use PATCH /posts/{id} instead), and 404 if the post isn't found in your organization.

Request

Responses

200

Draft scheduled (or queued to publish now)

400

Invalid request parameters

401

Missing or invalid API key

429

Rate limit exceeded

Response Headers

X-RateLimit-Limit

Request limit per window

X-RateLimit-Remaining

Remaining requests in current window

X-RateLimit-Reset

Unix timestamp when the window resets

Retry-After

Seconds to wait before retrying