POST /2/tweets

Creates a new Post for the authenticated user, or edits an existing Post when edit_options are provided. Supports paid partnership disclosure via the paid_partnership field.

Servers

https://api.x.com

Request headers

Name	Type	Required	Description
`Content-Type`	String	Yes	The media type of the request body. Default value: "application/json"

Request body fields

Name	Type	Required	Description
`poll`	Object	No	Poll options for a Tweet with a poll. This is mutually exclusive from Media, Quote Tweet Id, and Card URI.
`poll.options[]`	Array	Yes
`poll.duration_minutes`	Integer	Yes	Duration of the poll in minutes.
`poll.reply_settings`	String	No	Settings to indicate who can reply to the Tweet. Valid values: `"following"` `"subscribers"` `"mentionedUsers"` `"verified"`
`for_super_followers_only`	Boolean	No	Exclusive Tweet for super followers. Default value: false
`share_with_followers`	Boolean	No	Share community post with followers too. Default value: false
`community_id`	String	No	The unique identifier of this Community.
`geo`	Object	No	Place ID being attached to the Tweet for geo location.
`geo.place_id`	String	No
`paid_partnership`	Boolean	No	Whether this Post is a paid partnership. When true, the Post will be labeled as a paid promotion.
`reply`	Object	No	Tweet information of the Tweet being replied to.
`reply.auto_populate_reply_metadata`	Boolean	No	If set to true, reply metadata will be automatically populated.
`reply.in_reply_to_tweet_id`	String	Yes	Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.
`reply.exclude_reply_user_ids[]`	Array	No	A list of User Ids to be excluded from the reply Tweet.
`reply_settings`	String	No	Settings to indicate who can reply to the Tweet. Valid values: `"following"` `"subscribers"` `"mentionedUsers"` `"verified"`
`direct_message_deep_link`	String	No	Link to take the conversation from the public timeline to a private Direct Message.
`text`	String	No	The content of the Tweet.
`card_uri`	String	No	Card Uri Parameter. This is mutually exclusive from Quote Tweet Id, Poll, Media, and Direct Message Deep Link.
`media`	Object	No	Media information being attached to created Tweet. This is mutually exclusive from Quote Tweet Id, Poll, and Card URI.
`media.tagged_user_ids[]`	Array	No	A list of User Ids to be tagged in the media for created Tweet.
`media.media_ids[]`	Array	Yes	A list of Media Ids to be attached to a created Tweet.
`quote_tweet_id`	String	No	Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.
`made_with_ai`	Boolean	No	Whether this Post contains AI-generated media. When true, the Post will be labeled accordingly.
`edit_options`	Object	No	Options for editing an existing Post. When provided, this request will edit the specified Post instead of creating a new one.
`edit_options.previous_post_id`	String	Yes	Unique identifier of this Tweet. This is returned as a string in order to avoid complications with languages and tools that cannot handle large integers.
`nullcast`	Boolean	No	Nullcasted (promoted-only) Posts do not appear in the public timeline and are not served to followers. Default value: false

How to start integrating

Add HTTP Task to your workflow definition.
Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
Click Test request to test run your request to the API and see the API's response.