Write Actions

Create Tweet

Post a new tweet as the account behind your registered session. Supports plain text, up to 4 image media_ids (from a prior media/upload), a reply (reply_to), and a quote (quote). Requires a registered session. Billed at $0.0016 per call. Cost: $0.0016 per call.

post/tweet/create

Request

Base URL: https://api.twitterapis.com/twitter
URL: https://api.twitterapis.com/twitter/tweet/create
Auth: HTTP bearer

Request body

textstring required

The tweet body.

media_idsstring

Up to 4 media IDs from media/upload, as a comma-separated string or JSON array. Omit for a text-only tweet.

reply_tostring

ID of the tweet to reply to (send it as a string; X IDs are 19 digits). Omit for a top-level tweet.

quotestring

ID of the tweet to quote (send it as a string; X IDs are 19 digits).

Example request

{
  "text": "Shipping cursor-paginated bookmarks today.",
  "media_ids": "1899999999999999999",
  "reply_to": "2080297101888733302",
  "quote": "1900000000000000000"
}

Response

Post a tweet as your registered account: text, media, reply, or quote.

okboolean

True when the tweet was posted.

tweet_idstring nullable

Numeric ID of the created tweet, or null if the ID could not be resolved.

urlstring nullable

Canonical x.com URL of the created tweet, or null.

Changes

No recorded changes to this operation across all 1 revision of this API.