Skip to main content

Create post

POST 
/posts

Create a social media post. Specify content, target accounts, and optionally a schedule time. Three modes: (1) omit scheduled_for to publish immediately; (2) include scheduled_for to schedule for later; (3) set draft: true to save it as a DRAFT for human review — it is NOT published until you call POST /posts/{id}/schedule on it (review drafts via GET /posts?status=draft). For drafts, account_ids is optional.

Use platform_content to customise content per platform — override captions, set Instagram content type (Story, Reels, Post), configure TikTok privacy, set YouTube titles, and more.

Instagram Stories example:

{
  "content": "Check this out!",
  "account_ids": [123],
  "media_ids": ["uuid"],
  "platform_content": {
    "instagram": { "contentType": "Story" }
  }
}

Request​

Responses​

Post created