Skip to navigation

Social · Drafts · Schedule or queue draft posts

View as Markdown

Schedule drafts through the planner’s own draft flow: each draft is marked used and a new post is created from it, at the date and time stored on the draft (‘schedule’) or at the account’s next queue slot (‘add_to_queue’). Set the draft’s date first with updateSocialMediaDraft when the user named a time. Draft ids come from the create response for action ‘draft’ or from getSocialMediaDrafts. A draft that was already scheduled is reported as an error, not scheduled again. Returns the new post ids; read each one back with getSocialMediaPost.

Authentication

AuthorizationApi-Key

Header authentication of the form Api-Key <token>

OR
AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
draft_idslist of stringsRequired
Draft ids to schedule. Each draft must be linked to an account.
actionenumRequired

‘schedule’ uses the date and time stored on the draft; ‘add_to_queue’ uses the account’s next free queue slot.

Allowed values:
tzstringOptional

IANA timezone the draft’s date and time are read in, e.g. America/Los_Angeles. Omit to use the user’s planner timezone.

Response

Drafts scheduled
idslist of anyOptional
Planner post ids created from the drafts.
errorslist of anyOptional
Planner messages for drafts that could not be scheduled.