Skip to main content
POST
/
2
/
tweets
Create or Edit Post
curl --request POST \
  --url https://api.x.com/2/tweets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "card_uri": "<string>",
  "community_id": "1146654567674912769",
  "direct_message_deep_link": "<string>",
  "for_super_followers_only": false,
  "geo": {
    "place_id": "<string>"
  },
  "made_with_ai": true,
  "nullcast": false,
  "paid_partnership": true,
  "quote_tweet_id": "1346889436626259968",
  "reply_settings": "following",
  "share_with_followers": false,
  "text": "Learn how to use the user Tweet timeline and user mention timeline endpoints in the X API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"
}
'
{
  "data": {
    "id": "1346889436626259968",
    "text": "Learn how to use the user Tweet timeline and user mention timeline endpoints in the X API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"
  },
  "errors": [
    {
      "title": "<string>",
      "type": "<string>",
      "detail": "<string>",
      "status": 123
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.x.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json
​
card_uri
string

Card Uri Parameter. This is mutually exclusive from Quote Tweet Id, Poll, Media, and Direct Message Deep Link.

​
community_id
string

The unique identifier of this Community.

Pattern: ^[0-9]{1,19}$
Example:

"1146654567674912769"

​
direct_message_deep_link
string

Link to take the conversation from the public timeline to a private Direct Message.

​
edit_options
object

Options for editing an existing Post. When provided, this request will edit the specified Post instead of creating a new one.

​
for_super_followers_only
boolean
default:false

Exclusive Tweet for super followers.

​
geo
object

Place ID being attached to the Tweet for geo location.

​
made_with_ai
boolean

Whether this Post contains AI-generated media. When true, the Post will be labeled accordingly.

​
media
object

Media information being attached to created Tweet. This is mutually exclusive from Quote Tweet Id, Poll, and Card URI.

​
nullcast
boolean
default:false

Nullcasted (promoted-only) Posts do not appear in the public timeline and are not served to followers.

​
paid_partnership
boolean

Whether this Post is a paid partnership. When true, the Post will be labeled as a paid promotion.

​
poll
object

Poll options for a Tweet with a poll. This is mutually exclusive from Media, Quote Tweet Id, and Card URI.

​
quote_tweet_id
string

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.

Pattern: ^[0-9]{1,19}$
Example:

"1346889436626259968"

​
reply
object

Tweet information of the Tweet being replied to.

​
reply_settings
enum<string>

Settings to indicate who can reply to the Tweet.

Available options:
following,
mentionedUsers,
subscribers,
verified
​
share_with_followers
boolean
default:false

Share community post with followers too.

​
text
string

The content of the Tweet.

Example:

"Learn how to use the user Tweet timeline and user mention timeline endpoints in the X API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"

Response

The request has succeeded.

​
data
object
​
errors
object[]
Minimum array length: 1

An HTTP Problem Details object, as defined in IETF RFC 7807 (https://tools.ietf.org/html/rfc7807).