DocsReference

Bulk upload & auto-schedule

Upload 20 videos in one session, create drafts in bulk, then auto-distribute them across future days — e.g. 4 posts per day at optimal time slots.

1. Batch-request signed upload URLs

POST /v1/media/presign-upload/batch (max 50 files)

curl https://api.letspost.app/v1/media/presign-upload/batch \
  -H "Authorization: Bearer $SOCIALHUB_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "files": [
      { "fileName": "day1-morning.mp4", "contentType": "video/mp4" },
      { "fileName": "day1-noon.mp4", "contentType": "video/mp4" },
      { "fileName": "day1-evening.mp4", "contentType": "video/mp4" }
    ]
  }'

2. Create drafts in bulk

POST /v1/posts/bulk accepts up to 50 posts. Each is created as a draft — no publishing happens yet.

curl https://api.letspost.app/v1/posts/bulk \
  -H "Authorization: Bearer $SOCIALHUB_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "posts": [
      { "profileId": "prof_abc", "title": "Morning reel", "description": "Rise and grind", "mediaUrl": "uploads/…/a.mp4", "platforms": ["tiktok","instagram","youtube"] },
      { "profileId": "prof_abc", "title": "Noon drop", "description": "Lunchtime content", "mediaUrl": "uploads/…/b.mp4", "platforms": ["tiktok","instagram","youtube"] }
    ]
  }'

3. Auto-schedule

POST /v1/posts/auto-schedule distributes drafts across future days. Default: 4 per day at 09:00, 12:00, 17:00, 20:00 UTC.

curl https://api.letspost.app/v1/posts/auto-schedule \
  -H "Authorization: Bearer $SOCIALHUB_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "postIds": ["pst_1","pst_2","pst_3","pst_4","pst_5","pst_6","pst_7","pst_8"],
    "postsPerDay": 4,
    "startDate": "2026-04-20",
    "timeSlots": ["09:00","12:00","17:00","20:00"]
  }'

Config options

Field	Default	Description
`postsPerDay`	4	How many posts per day.
`startDate`	Tomorrow	ISO date string (YYYY-MM-DD).
`timeSlots`	09:00, 12:00, 17:00, 20:00	UTC times. Array length should ≥ postsPerDay.

Full pipeline example

Upload 20 clips → bulk-create 20 drafts → auto-schedule at 4/day starting tomorrow → 5 days of content queued. Each post publishes to TikTok, Instagram and YouTube automatically at the scheduled time.

Was this page helpful?

Something unclear? Email us — we read every message.