Skip to main content
POST
Start scheduling posts

Authorizations

api_key
string
header
required

Personal API key.

Path Parameters

app_id
string
required

ID of the app whose social calendar you want.

Body

application/json
scheduled_from
string<date-time>
required

Start of the range to schedule, inclusive, as an ISO 8601 timestamp carrying an offset. A timestamp without one fails with a 422.

Example:

"2026-09-01T00:00:00Z"

scheduled_until
string<date-time>
required

End of the range, exclusive, as an ISO 8601 timestamp carrying an offset. It has to be later than scheduled_from.

Example:

"2026-10-01T00:00:00Z"

Response

The scheduling job that is now running, or the one already in flight for this range.

job_id
string
required

ID of the scheduling job. Pass it as job_id to Get scheduling job.

Example:

"68a1c4f0d21b4e0a3c77e912"

status
string
required

State of the job: pending before it starts, running while it hands posts over, then completed or failed. A range holding nothing to schedule comes back completed straight away.

Example:

"pending"