Skip to main content
POST
/
schedule
/
posts
Create Scheduled Post
curl --request POST \
  --url https://api.supapost.so/schedule/posts \
  --header 'Content-Type: application/json' \
  --data '
{
  "social_account_id": "<string>",
  "platform": "<string>",
  "scheduled_at": "<string>",
  "project_id": "<string>",
  "title": "<string>",
  "image_urls": [
    "<string>"
  ]
}
'
{
  "id": "post-uuid",
  "team_id": "team-uuid",
  "project_id": "proj-uuid",
  "social_account_id": "acct-uuid",
  "platform": "tiktok",
  "scheduled_at": "2026-04-10T14:00:00Z",
  "title": "Morning Routine Tips",
  "image_urls": ["https://cdn.supapost.so/assets/team/slide1.jpg"],
  "status": "scheduled",
  "project": {
    "id": "proj-uuid",
    "name": "Morning Routine Carousel",
    "thumbnail_url": "https://cdn.supapost.so/assets/team/thumb.jpg"
  },
  "account": {
    "id": "acct-uuid",
    "platform": "tiktok",
    "platform_username": "myaccount",
    "display_name": "My Account",
    "avatar_url": "https://example.com/avatar.jpg"
  }
}
Creates a new scheduled post. The scheduled_at time must be in the future. A cron job will automatically publish the post at the scheduled time.

​
Authentication

​
Authorization
string
Bearer token. Bearer <supabase-jwt>.

​
Body

​
social_account_id
string
required
ID of the connected social account to publish to.
​
platform
string
required
Target platform, e.g. "tiktok".
​
scheduled_at
string
required
ISO 8601 datetime for when the post should be published. Must be in the future.
​
project_id
string
Optional project ID to link this post to.
​
title
string
default:"Scheduled post"
Title or caption for the post.
​
image_urls
string[]
required
Array of image URLs to include in the post.
{
  "id": "post-uuid",
  "team_id": "team-uuid",
  "project_id": "proj-uuid",
  "social_account_id": "acct-uuid",
  "platform": "tiktok",
  "scheduled_at": "2026-04-10T14:00:00Z",
  "title": "Morning Routine Tips",
  "image_urls": ["https://cdn.supapost.so/assets/team/slide1.jpg"],
  "status": "scheduled",
  "project": {
    "id": "proj-uuid",
    "name": "Morning Routine Carousel",
    "thumbnail_url": "https://cdn.supapost.so/assets/team/thumb.jpg"
  },
  "account": {
    "id": "acct-uuid",
    "platform": "tiktok",
    "platform_username": "myaccount",
    "display_name": "My Account",
    "avatar_url": "https://example.com/avatar.jpg"
  }
}