Welcome to Typefully’s API, which will let you create drafts programmatically, schedule them, get existing drafts, and more.

To see a production example of our API, check the source code for Typefully’s Raycast Extension.

Authentication

Get an API key

You can get an API key from Settings > Integrations.

API keys let you use the API for a given 𝕏 / Twitter account you have connect to Typefully. Switch account from the account menu to generate keys for another account.

Authorizing API requests

Include this header in all the requests you make:

X-API-KEY

Bearer TYPEFULLY_API_KEY

Endpoints

API root URL: https://api.typefully.com/v1

Create a draft

Create a draft given some plain-text content.

POST /v1/drafts/

Payload (JSON):

{ "content": "First tweet of a beautiful thread" }

Options:

Name

Required