Create Posts
Media attachments
Upload media first with the chunked upload endpoints, then pass the returnedmedia_id in media.media_ids.
A Post may include up to 4 photos, 1 animated GIF, or 1 video.
Duration and file size are checked again at Post create. They follow the posting user’s X Premium / verified status and the media_category used at upload — not your developer API plan.
tweet_video and amplify_video. If the video is longer than that user is allowed to post, the response is 403 Forbidden:
Authorizations
The access token received from the authorization server in the OAuth 2.0 flow.
Body
Card URI parameter.
Community to post the tweet to.
^[0-9]{1,19}$Direct message deep link.
Edit an existing tweet rather than creating a new one.
Restrict tweet to super followers.
Geo location for the tweet.
Disclose that the tweet contains AI-generated media.
Media attachments.
If true, the tweet is not shown in the public timeline.
Disclose that the tweet is a paid partnership.
Poll configuration.
Tweet ID to quote.
^[0-9]{1,19}$Tweet reply configuration.
Who can reply to this tweet.
following, mentionedUsers, subscribers, verified Share an exclusive (super-follower) tweet with all followers.
Text of the tweet. Required unless media is provided. Defaulted to an empty string so it is always sent: the backend's tweet_text variable is non-null and rejects an absent value.