Threads API and MCP

Build a Threads publish request and check the platform's media requirements before submission.

Use threads as the platform value. No extra target identifier is required after selecting accountId.

Fields

Field	Use
replyControl	Optional: everyone, accounts_you_follow, or mentioned_only.
additionalPosts	Optional thread posts, each with text and mediaUrls. For REST, place this in post.content.

For MCP, pass platform-specific fields alongside accountId, platform, text, and mediaUrls. For REST, platform-specific target fields belong inside post.target. Thread content belongs inside post.content.additionalPosts.

Media and formats

Each post accepts text, one image, or one video. Multiple media URLs in a single Threads post fail. To share several images, create a thread with one image per post using additionalPosts.

Read Threads media requirements and upload and conversion rules. Public media URLs go directly in mediaUrls. No upload step required.

MCP example

Call blotato_create_post with the following shape. Replace lookup IDs and example media URLs with returned IDs and your media. Adjust the example's settings to the user's request.

{
  "accountId": "ACCOUNT_ID_FROM_LOOKUP",
  "platform": "threads",
  "text": "A post for Threads.",
  "mediaUrls": []
}

REST example

Send this JSON to POST https://backend.blotato.com/v2/posts with your blotato-api-key header.

{
  "post": {
    "accountId": "ACCOUNT_ID_FROM_LOOKUP",
    "content": {
      "platform": "threads",
      "text": "A post for Threads.",
      "mediaUrls": []
    },
    "target": {
      "targetType": "threads"
    }
  }
}

Verify the result

1. Save the returned postSubmissionId.

2. If processing continues, use blotato_get_post_status or GET /v2/posts/:postSubmissionId.

3. Report the returned status and public URL when supplied.

For scheduling, add scheduledTime or useNextFreeSlot as an MCP argument or a REST top-level sibling of post. See Scheduling and completion rules.

Limits and troubleshooting

A Threads thread and a media carousel are different structures. Use one media item per post even if a generic media schema allows larger arrays.

See Threads account guide, platform help, and the Publish Post reference for options and examples.