---
title: "Schedule Tweet"
method: POST
path: "/scheduled/create"
tags: ["Write Actions"]
---

# Schedule Tweet

`POST /scheduled/create`

## Request

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

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.

## Request body

- object
  - `text` string, required: The tweet body. Required: a scheduled post with no text is refused with 400.
  - `execute_at` integer, 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_ids` string: Up to 4 media IDs from media/upload, as a comma-separated string or a JSON array.
  - `reply_to` string: ID of the tweet this post replies to (send it as a string).
  - `quote` string: ID of the tweet this post quotes (send it as a string).

## Response `200`

Schedule a tweet to post publicly at a future instant.

- object
  - `ok` boolean: True when X returned an id for the scheduled post.
  - `scheduled_tweet_id` string, nullable: Numeric ID of the scheduled post, or null when X refused it. A null here answers 422 and is not billed.
  - `execute_at` integer: The instant you scheduled, echoed back in epoch SECONDS, the same unit you sent.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `402`: Insufficient credits
- `403`: Forbidden
- `404`: Not found
- `429`: Rate limited
- `5XX`: Server error

---

[API](https://skmtc.dev/twitterapis/apis/twitterapis-api.md) · [All operations](https://skmtc.dev/twitterapis/apis/twitterapis-api/llms.txt) · [OpenAPI document](https://skmtc.dev/twitterapis/apis/twitterapis-api/revisions/a33ce0fedb3c?raw)