X (Twitter) API and MCP

Publish text or supported media to the selected X account using the twitter platform value.

Use twitter as the platform value, including when the user calls the service X. No extra target identifier is required after selecting accountId.

Fields

Field	Use
additionalPosts	Optional thread posts, each with text and mediaUrls. For REST, put this array inside post.content, outside post.target.

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

Publish text, images, or a video. For a thread, use the main post plus additionalPosts. Validate each post's media and text rather than treating the thread as one caption.

Read X (Twitter) 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": "twitter",
  "text": "A post for X.",
  "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": "twitter",
      "text": "A post for X.",
      "mediaUrls": []
    },
    "target": {
      "targetType": "twitter"
    }
  }
}

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

Account-specific text limits and platform errors still apply. Follow the X FAQ for account questions and the returned validation message for a rejected post.

See X (Twitter) account guide, platform help, and the Publish Post reference for options and examples.