Sign in

v1

latestOpenAPI 3.0.0Twitter Developer Agreement and Policy2026-07-1480235216.3 KB
Tweets

Creation of a Tweet

Causes the User to create a Tweet under the authorized account.

post/2/tweets

Request body

card_uristring

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

direct_message_deep_linkstring

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

for_super_followers_onlyboolean

Exclusive Tweet for super followers.

nullcastboolean

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

quote_tweet_idstring

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_settings'following' | 'mentionedUsers'

Settings to indicate who can reply to the Tweet.

textstring

The content of the Tweet.

Example request

{
  "media": {
    "media_ids": [
      "1146654567674912769"
    ],
    "tagged_user_ids": [
      "2244994945"
    ]
  },
  "quote_tweet_id": "1346889436626259968",
  "reply": {
    "exclude_reply_user_ids": [
      "2244994945"
    ],
    "in_reply_to_tweet_id": "1346889436626259968"
  },
  "text": "Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"
}

Response

The request has succeeded.

Example response

{
  "data": {
    "id": "1346889436626259968",
    "text": "Learn how to use the user Tweet timeline and user mention timeline endpoints in the Twitter API v2 to explore Tweet\\u2026 https:\\/\\/t.co\\/56a0vZUx7i"
  }
}