Platform rules and options

Text for each platform#

content goes to every platform unless one has its own text in platformContent. Use it for a short X version, hashtags on Instagram, or anything else that should differ. Rules are checked against each platform's own text.

{
  "content": "Our biggest update yet: dark mode, faster search and a new editor.",
  "platformContent": {
    "x": "Dark mode is here 🌙",
    "instagram": "Our biggest update yet ✨ #productupdate #darkmode",
    "threads": "Dark mode, faster search and a new editor. What should we build next?"
  },
  "accountIds": [
    "…"
  ],
  "publishNow": true
}

Photos and videos#

• Upload with POST /api/v1/media or the MCP upload_image tool, then pass ids in mediaIds (up to 10, in display order).
• Photos: JPEG, PNG or WebP up to 30 MB, converted to JPEG. Videos: MP4 or MOV up to 512 MB.
• For videos sent through the API, pass width, height and durationMs when uploading so length and shape are checked before scheduling.
• Seven days after a post has gone out everywhere, its original files are deleted (the platforms keep their copies); 30 days after a failure that nobody retried. Media that was cleaned up can't be attached to a new post.

At a glance#

X#

Text counts by X's weights: most CJK characters and emoji count as 2, and every link counts as 23.

Each X post costs 10 credits, or 80 when it contains a link, for every selected X account. Thread posts and an X first comment are charged the same way, up front; anything that doesn't go out is refunded.

{
  "platformContent": {
    "x": "We rebuilt our editor from scratch. Here's what changed 🧵"
  },
  "xThread": [
    "1. It's 3x faster on big documents.",
    {
      "text": "2. Everything works offline now.",
      "mediaIds": [
        "…"
      ]
    },
    "Try it today: https://example.com/editor"
  ],
  "accountIds": [
    "…"
  ],
  "scheduledAt": "2026-10-12T09:00:00Z"
}

Instagram#

Business and Creator accounts. One photo is a feed post, one video is a Reel, and several items make a carousel.

instagramFormat: "story" posts a Story instead: exactly one photo or video, and Instagram doesn't show captions on Stories.

Threads#

Any Threads profile. Text-only posts are fine. Emoji count as their UTF-8 bytes (usually 4), as Threads counts them.

Facebook#

Facebook Pages (not personal profiles). Each Page you connect is its own account.

TikTok#

TikTok asks the person posting to choose who can see each post and to disclose commercial content. Set these in tiktok; agents should ask rather than guess.

While our TikTok app is in TikTok's review, TikTok makes every post private (Only me), whatever privacy says.

{
  "content": "Our spring collection is here",
  "tiktok": {
    "privacy": "PUBLIC_TO_EVERYONE",
    "allowComments": true,
    "allowDuet": false,
    "allowStitch": false,
    "yourBrand": true,
    "coverTimestampMs": 2500
  },
  "mediaIds": [
    "…"
  ],
  "accountIds": [
    "…"
  ],
  "scheduledAt": "2026-10-12T18:00:00Z"
}

Posting to TikTok means you agree to TikTok's Music Usage Confirmation, and to its Branded Content Policy for branded content.

YouTube#

Posts are YouTube Shorts: one vertical or square video. The post's text becomes the description.

Pinterest#

Pins go to the board picked for the account on the Connections page; there's no board parameter in the API. The Pin title is the first line of the text, up to 100 characters.