POST /2/tweets

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

Servers

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.

Possible values:

  • "following"
  • "subscribers"
  • "mentionedUsers"
  • "verified"
for_super_followers_only Boolean No

Exclusive Tweet for super followers.

Default value: false

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.

community_id String No

The unique identifier of this Community.

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.

geo Object No

Place ID being attached to the Tweet for geo location.

geo.place_id String No
reply Object No

Tweet information of the Tweet being replied to.

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.

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.

reply_settings String No

Settings to indicate who can reply to the Tweet.

Possible values:

  • "following"
  • "subscribers"
  • "mentionedUsers"
  • "verified"
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

  1. Add HTTP Task to your workflow definition.
  2. 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.
  3. Click Test request to test run your request to the API and see the API's response.