This guide is about our new v2 API released in December 2025.
Typefully's public API is built using REST principles and lets you programmatically create, schedule, and publish content across all the platforms Typefully supports—X (Twitter), LinkedIn, Threads, Bluesky, and Mastodon.
We have a new API documentation page that provides complete endpoint documentation, request/response schemas, code examples, and API playground for you to try out the API
What you can do
The Typefully API supports:
Drafts: Create, edit, schedule, publish, and delete drafts programmatically
Multi-platform publishing: Post to X, LinkedIn, Threads, Bluesky, and Mastodon from a single API call
Media uploads: Upload images, videos, GIFs, and PDFs to include in your posts
Tags: Organize your content with tags for better workflow management
Social sets: Manage multiple brand or personal accounts, each with their own connected platforms
Webhooks: Receive notifications when events occur (like drafts being published)
Before building with this API for X automation, please review these critical guidelines:
Make sure to adhere to X automation rules and general X rules when scheduling content, otherwise your X account might be banned.
If you plan to build an app on X that is not just for you or your company to use, you will need to use the X API with higher rate limits than Typefully's API, which is meant to create personal automations and workflows.
Getting started
Authentication
The API uses API keys for authentication. You can create and manage API keys from Settings → API in Typefully.
Include your API key in the request header:
Authorization: Bearer YOUR_API_KEY
Development mode
When building with the API, enable Development mode in Settings → API. This shows IDs for social sets, drafts, and media directly in the Typefully UI, making it easier to reference the right resources in your API calls. You can also toggle this anytime via the Command Bar (⌘K).
Webhooks
Webhooks let you receive real-time HTTP notifications when events happen in Typefully and are useful for triggering downstream workflows. For complete guide on Webhook setup, see the webhooks section in our API docs.
For example, notifying your team in Slack when content goes live or syncing published content to a database or CMS.
Configure webhook URLs in Settings → API by clicking + Add webhook.
Supported events
Event | Description |
Draft Created | When a new draft is created |
Draft Published | When a draft is published to social media |
Draft Scheduled | When a draft is scheduled for later publishing |
Draft Status Changed | When a draft's status is changed (e.g., from scheduled to published) |
Draft Tags Changed | When tags are added or removed from a draft |
Draft Deleted | When a draft is permanently deleted |
Common use cases
Content pipelines: Connect your CMS, Notion, or newsletter to automatically create drafts when new content is ready or published.
AI Agent workflows: Use the API to build AI agents that operate on your Typefully account and content.
Team and collaboration automation: Build internal tools that notify in Slack when tags change or when content is published. Or build tools to let team members submit content ideas that get queued as drafts for review.
Cross-posting: Schedule the same content across multiple platforms, even platforms that Typefully does not yet support.
Rate limits and usage
The API is designed for personal automations and team workflows and we have rate limits that match that. If you're building a public-facing application that will serve many users, please reach out to discuss your use case.
When using the API to schedule content, make sure to follow the platform guidelines for each network you're posting to—particularly X's automation rules.
Example: Creating a draft
Here's a quick example bash command for creating a draft for X:
curl -X POST https://api.typefully.com/v2/drafts \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"platforms": {
"x": {
"enabled": true,
"posts": [
{"text": "Just shipped a new feature! 🚀"}
]
}
}
}'
You can also create multi-post threads, schedule for a specific time, or publish immediately by adding additional parameters. See the full API documentation for all available options.
Get help
If you have questions the docs don't answer:
Join our Discord community for help and discussion
Email us at [email protected]