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 '
{
  "socialAccountId": "<string>",
  "platform": "<string>",
  "scheduledAt": "<string>",
  "projectId": "<string>",
  "title": "<string>",
  "imageUrls": [
    "<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 scheduledAt 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

​
socialAccountId
string
required
ID of the connected social account to publish to.
​
platform
string
required
Target platform, e.g. "tiktok".
​
scheduledAt
string
required
ISO 8601 datetime for when the post should be published. Must be in the future.
​
projectId
string
Optional project ID to link this post to.
​
title
string
default:"Scheduled post"
Title or caption for the post.
​
imageUrls
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"
  }
}