REST APIPOST

Publish Draft

Publish a saved draft now, or schedule it for a date you pass or for the planned date the draft was saved with.

POSThttps://post.adaptlypost.com/post/api/v1/social-posts/:id/publish

Publish a previously saved draft post, or schedule it. A draft saved with a future scheduledAt is scheduled for that date unless you send publishNow.

API Key (Bearer token)
Permission:posts.draftRoles and permissions

Scheduling for a future date, whether it comes from scheduledAt or from the draft's planned date, needs posts.schedule. Publishing now needs posts.publish. Another member's draft also needs posts.others. A Contributor key cannot call this endpoint at all.

Body Parameters

ParameterTypeDescription
scheduledAtstringISO 8601 date to schedule for, instead of the draft's planned date. A past date publishes now. Omit it to use the planned date, or to publish now when the draft has none.
timezoneREQUIREDstringIANA timezone (required)
publishNowbooleanPublish now even when the draft has a planned date. Sending it with scheduledAt returns 400.
With scheduledAt, the post is scheduled for that time. Without it, a draft with a future planned date is scheduled for that date, and any other draft publishes now. Send publishNow: true to publish a dated draft now. Publishing now clears the stored scheduledAt.
Publish a Draft Post
curl --request POST \
  --url https://post.adaptlypost.com/post/api/v1/social-posts/post_xyz789/publish \
  --header 'Authorization: Bearer <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
    "scheduledAt": "2026-03-15T10:00:00Z",
    "timezone": "America/New_York"
  }'
201
{
  "postId": "post_xyz789",
  "queuedPlatforms": ["TWITTER", "LINKEDIN"],
  "isScheduled": true,
  "scheduledAt": "2026-03-15T10:00:00Z"
}