---
title: "Creation of a Tweet"
method: POST
path: "/2/tweets"
tags: ["Tweets"]
---

# Creation of a Tweet

`POST /2/tweets`

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

## Request body

- TweetCreateRequest
  - `card_uri` string — Card Uri Parameter. This is mutually exclusive from Quote Tweet Id, Poll, Media, and Direct Message Deep Link.
  - `direct_message_deep_link` string — Link to take the conversation from the public timeline to a private Direct Message.
  - `for_super_followers_only` boolean — Exclusive Tweet for super followers.
  - `geo` object — Place ID being attached to the Tweet for geo location.
    - `place_id` string
  - `media` object — Media information being attached to created Tweet. This is mutually exclusive from Quote Tweet Id, Poll, and Card URI.
    - `media_ids` MediaId[], required — A list of Media Ids to be attached to a created Tweet.
    - `tagged_user_ids` UserId[] — A list of User Ids to be tagged in the media for created Tweet.
  - `nullcast` boolean — Nullcasted (promoted-only) Tweets do not appear in the public timeline and are not served to followers.
  - `poll` object — Poll options for a Tweet with a poll. This is mutually exclusive from Media, Quote Tweet Id, and Card URI.
    - `duration_minutes` integer, required — Duration of the poll in minutes.
    - `options` string[], required
    - `reply_settings` 'following' | 'mentionedUsers' — Settings to indicate who can reply to the Tweet.
  - `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.
  - `reply` object — Tweet information of the Tweet being replied to.
    - `exclude_reply_user_ids` UserId[] — A list of User Ids to be excluded from the reply Tweet.
    - `in_reply_to_tweet_id` string, required — 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.
  - `text` string — The content of the Tweet.

## Response `201`

The request has succeeded.

- TweetCreateResponse
  - `data` object
    - `id` string, required — 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.
    - `text` string, required — The content of the Tweet.
  - `errors` Problem[]
    - `detail` string
    - `status` integer
    - `title` string, required
    - `type` string, required

## Other responses

- `default` — The request has failed.

---

[API](https://skmtc.net/mfullbrook/apis/current.md) · [All operations](https://skmtc.net/mfullbrook/apis/current/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mfullbrook/current/versions/4b066912ce32/schema)