Scheduling

Overview

Schedule your slideshows to publish automatically at a specific date and time. A Cloudflare Workers cron job checks every minute for due posts and publishes them.

Scheduling from the Editor

Create your slides in Studio > Slides
Click the dropdown arrow next to Export
Under Schedule, select your connected account
Pick a date and time
Click Schedule

The slides are exported, uploaded to R2, and a scheduled post is created.

Scheduling via API

curl -X POST https://api.supapost.so/schedule/posts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "social_account_id": "account-uuid",
    "platform": "tiktok",
    "scheduled_at": "2026-04-10T14:00:00Z",
    "title": "Morning routine tips",
    "image_urls": [
      "https://cdn.supapost.so/exports/slide-1.jpg",
      "https://cdn.supapost.so/exports/slide-2.jpg"
    ]
  }'

Post Statuses

Status	Description
`scheduled`	Waiting to be published at the scheduled time
`publishing`	Currently being published (in progress)
`published`	Successfully published to the platform
`failed`	Publishing failed — check `error_message` for details
`cancelled`	Manually cancelled by the user

Managing Scheduled Posts

# List scheduled posts for a date range
curl "https://api.supapost.so/schedule/posts?from=2026-04-07&to=2026-04-14" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Reschedule a post
curl -X PATCH https://api.supapost.so/schedule/posts/POST_ID \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"scheduled_at": "2026-04-11T16:00:00Z"}'

# Cancel a post
curl -X PATCH https://api.supapost.so/schedule/posts/POST_ID \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"status": "cancelled"}'

Getting Started

Core Concepts

Overview

Scheduling from the Editor

Scheduling via API

Post Statuses

Managing Scheduled Posts

​Overview

​Scheduling from the Editor

​Scheduling via API

​Post Statuses

​Managing Scheduled Posts

Overview

Scheduling from the Editor

Scheduling via API

Post Statuses

Managing Scheduled Posts