X (Twitter)

X supports text-only tweets, tweets with images, and tweets with video. No additional platform settings are required.

Media Constraints

Constraint	Images	Videos
Formats	JPEG, PNG	MP4 (H.264 + AAC)
Max file size	5 MB	512 MB
Max count per post	4	1
Max duration	n/a	2 min 20 sec (140 seconds)
Text-only	Supported	Supported
Mix images + video	Not allowed	Not allowed

Platform Settings

One optional setting, under platform_settings.x. Leave the object out for a plain post.

Parameter	Type	Required	Description
`tagged_user_ids`	string[]	Optional	Up to 10 numeric X user IDs to tag in the post's photos or video. Only used when the post has media; ignored on text-only posts. Send IDs, not @handles.

Examples

Text-only tweet

{
  "type": "now",
  "caption": "Just launched a new AI room redesign feature. Try it out and let me know what you think!",
  "account_ids": ["x-account-id"]
}

Tweet with images

{
  "type": "schedule",
  "scheduled_at": "2026-06-01T14:00:00.000Z",
  "caption": "Before and after room transformation using AI. The results are incredible.",
  "media_ids": ["image-id-1", "image-id-2"],
  "account_ids": ["x-account-id"]
}

Tweet with video

{
  "type": "schedule",
  "scheduled_at": "2026-06-01T18:00:00.000Z",
  "caption": "Watch this 60 second room transformation",
  "media_ids": ["video-id"],
  "account_ids": ["x-account-id"]
}

Caption Rules

Max length

280 characters for every X account, each link counted at its full length. Longer captions are rejected before the post is saved.

To send a longer caption to the post's other platforms, give X its own in platform_settings.x.caption: the 280-character limit is checked against that text instead.

Daily Limit

Each X account takes up to 5 posts a day, because X's API charges for every post. Its scheduled, posting and published posts on that day count; drafts don't. A post that would be an X account's sixth of the day returns 400 VALIDATION_ERROR naming the account. No other platform has a daily limit.