Skip to main content

​
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

  1. Create your slides in Studio > Slides
  2. Click the dropdown arrow next to Export
  3. Under Schedule, select your connected account
  4. Pick a date and time
  5. 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 '{
    "socialAccountId": "account-uuid",
    "platform": "tiktok",
    "scheduledAt": "2026-04-10T14:00:00Z",
    "title": "Morning routine tips",
    "imageUrls": [
      "https://cdn.supapost.so/exports/slide-1.jpg",
      "https://cdn.supapost.so/exports/slide-2.jpg"
    ]
  }'

​
Post Statuses

StatusDescription
scheduledWaiting to be published at the scheduled time
publishingCurrently being published (in progress)
publishedSuccessfully published to the platform
failedPublishing failed — check error_message for details
cancelledManually 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 '{"scheduledAt": "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"}'