Schedule and publish

Create scheduled posts, publish now, and post X threads.

Post routes need Bearer auth and X-Workspace-Id.

Schedule a post

POST /api/posts/schedule

curl -X POST https://api.dunsocial.com/api/posts/schedule \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "X-Workspace-Id: YOUR_WORKSPACE_ID" \
-H "Content-Type: application/json" \
-d '{
  "socialAccountIds": ["ACCOUNT_ID"],
  "content": "Shipping something small today.",
  "scheduledAt": "2026-08-01T15:00:00.000Z",
  "mediaUrls": []
}'

Returns 201 with one post per social account.

Publish now

POST /api/posts/publish-now

Same body as schedule, without scheduledAt. Optional naturalPosting boolean.

Threads (X only)

Body shape:

{
"socialAccountId": "ACCOUNT_ID",
"scheduledAt": "2026-08-01T15:00:00.000Z",
"tweets": [
  { "content": "First tweet", "mediaUrls": [] },
  { "content": "Second tweet" }
]
}

Threads need 2–25 tweets. Response includes threadHeadPost, totalTweets, and postIds.

Platform options in metadata

Pass platform-specific fields in metadata when needed:

Media on a post

mediaUrls can be media asset ids, https://media.dunsocial.com/... URLs, or storage keys like media/uploads/....

Common errors

Check cap usage: GET /api/posts/x-cap-usage