Skip to main content
POST
Create draft
Free - does not consume credits

Headers

x-api-key
string
required
Your API key. Session cookie authentication is also supported. Generate a key from the dashboard.
Content-Type
string
required
Must be application/json.

Body

text
string
required
The draft tweet text. Must be non-empty. Maximum 25,000 characters.
topic
string
Topic the tweet is about. Used for composition guidance. Maximum 500 characters (silently truncated if longer).
goal
string
Optimization goal. One of: engagement, followers, authority, conversation. Invalid values are silently ignored.

Response

id
string
Unique draft ID.
text
string
The draft tweet text.
topic
string
Topic the tweet is about. Omitted if not set.
goal
string
Optimization goal. Omitted if not set.
createdAt
string
ISO 8601 creation timestamp.
updatedAt
string
ISO 8601 last update timestamp.
Next steps: List Drafts to see all your drafts, Get Draft to fetch a specific draft, or Delete Draft to remove one.
Last modified on May 5, 2026