Write Actions

Schedule Tweet

Schedule a tweet from the account behind your registered session for a future instant. Unlike a draft, this WILL post publicly at execute_at unless you delete it first. execute_at is epoch SECONDS and must be in the future; a millisecond value is refused by name rather than scheduled tens of thousands of years out. Billed at $0.0016 per call. Cost: $0.0016 per call.

post/scheduled/create

Request

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

Request body

textstring required

The tweet body. Required: a scheduled post with no text is refused with 400.

execute_atinteger required

When to post, as epoch SECONDS in the future. A value at or above 1000000000000 is rejected as milliseconds, with a message saying so, rather than accepted. Also accepted as schedule_at.

media_idsstring

Up to 4 media IDs from media/upload, as a comma-separated string or a JSON array.

reply_tostring

ID of the tweet this post replies to (send it as a string).

quotestring

ID of the tweet this post quotes (send it as a string).

Example request

{
  "text": "The Q1 changelog is live.",
  "media_ids": "1899999999999999999",
  "reply_to": "2080297101888733302",
  "quote": "1900000000000000000"
}

Response

Schedule a tweet to post publicly at a future instant.

okboolean

True when X returned an id for the scheduled post.

scheduled_tweet_idstring nullable

Numeric ID of the scheduled post, or null when X refused it. A null here answers 422 and is not billed.

execute_atinteger

The instant you scheduled, echoed back in epoch SECONDS, the same unit you sent.

Changes

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