Schedule and cancel

Create a schedule

Check capabilities.schedulePosts. Send the same platform-specific publishing input to /scheduled-posts, adding scheduledAt. This text example supports Threads, X, and LinkedIn; replace the account ID.

Replace <future-time-with-offset> with a future ISO 8601 timestamp within 360 days. For example, T09:00:00+09:00 on your chosen future date represents 9 a.m. in Korea. timezone is an IANA name; it defaults to the workspace setting, then UTC. The offset in scheduledAt determines the instant.

curl --request POST "https://www.posteady.com/api/v1/scheduled-posts" \
  --header "Authorization: Bearer $POSTEADY_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "accountIds": [
    "11111111-1111-4111-8111-111111111111"
  ],
  "posts": [
    "See you tomorrow!"
  ],
  "scheduledAt": "<future-time-with-offset>",
  "timezone": "Asia/Seoul"
}'

Save scheduledPostIds from the text result and inspect every account when scheduling to multiple accounts. For TikTok, Instagram, YouTube, or Facebook, use the input from its platform guide and add the same scheduling fields.

Text scheduling returns HTTP 502 if all targets fail. An accepted asynchronous schedule is not yet published. For replay status codes, see Idempotency and retries.

List schedules

curl --request GET "https://www.posteady.com/api/v1/scheduled-posts?provider=threads" \
  --header "Authorization: Bearer $POSTEADY_API_KEY"

Read scheduledPostId and platform from the scheduledPosts array. Omit provider to include supported platforms. This endpoint has no date-filter or pagination parameters. For asynchronous schedules, use jobId to track publication.

Cancel a schedule

Replace this illustrative ID with the actual scheduledPostId and use its matching platform.

curl --request DELETE "https://www.posteady.com/api/v1/scheduled-posts/55555555-5555-4555-8555-555555555555?platform=threads" \
  --header "Authorization: Bearer $POSTEADY_API_KEY"

{
  "canceled": 1
}

Canceling one entry in a Threads or X chain can cancel the whole chain; check the canceled count. TikTok, Instagram, YouTube, and Facebook jobs can only be canceled before submission begins; afterward they return 409 POST_NOT_CANCELLABLE. Cancellation does not delete a published social post.

Accepted Instagram and Facebook API schedules keep their content, media, and target fixed. Posteady allows rescheduling the time or canceling before publication starts. Facebook immediate jobs and unknown jobs do not appear in the schedule list.

Platform inputs · Schedule reference