X (Twitter) API guide

Publish posts with up to four images to X. Platform key: twitter.

Last checked against the API October 10, 2026 · View as Markdown

Platform keytwitter
Text limit280 characters, including hashtags
MediaUp to 4 images. Videos are not posted to X.

Things to know

  • The platform key is twitter.
  • Text over 280 characters (with hashtags) is cut and ends with an ellipsis, so write the X version to fit.

Example

POST /api/v1/posts
{
  "base_content": "Our autumn menu is here.",
  "platforms": ["twitter"],
  "platform_content": {
    "twitter": {
      "content": "Our autumn menu is here. Which drink first?"
    }
  },
  "scheduled_at": "2026-10-16T09:30:00Z"
}

Other platforms: LinkedIn, TikTok, YouTube, Pinterest, Bluesky. Writing limits for every network are in our character limit reference, and the X (Twitter) scheduler page covers scheduling from the app.

PreviousLinkedInNextTikTok