# Postbase

> Open-source, MCP-native, multi-channel social scheduler.

- [Introduction](https://docs.postbase.so/general/introduction.md): Postbase is an open-source, MCP-native, multi-channel social scheduler.
- [Quickstart](https://docs.postbase.so/general/quickstart.md): Connect a channel and schedule your first post in a couple of minutes.
- [Channels](https://docs.postbase.so/using/channels.md): Connect the social accounts you publish to.
- [Composer](https://docs.postbase.so/using/composer.md): Write once, tailor per platform, and schedule.
- [Calendar & queue](https://docs.postbase.so/using/calendar.md): See everything scheduled, and manage drafts and the publish queue.
- [Media library](https://docs.postbase.so/using/media.md): Upload images and video once, reuse them across posts.
- [Analytics](https://docs.postbase.so/using/analytics.md): See how your published posts perform.
- [Two-factor authentication](https://docs.postbase.so/using/two-factor.md): Ask for a code from an authenticator app every time you sign in.
- [Generate media](https://docs.postbase.so/ai/generate.md): Create images and short videos with AI, right in the composer.
- [Plans & limits](https://docs.postbase.so/cloud/plans.md): Postbase Cloud pricing, channels, seats, and AI quotas.
- [Billing](https://docs.postbase.so/cloud/billing.md): Upgrade, change plans, and manage your subscription.
- [MCP overview](https://docs.postbase.so/mcp/overview.md): Let an AI agent schedule and publish for you over the Model Context Protocol.
- [Connect a client](https://docs.postbase.so/mcp/connect.md): Add the Postbase MCP connector to your AI tool.
- [Tools](https://docs.postbase.so/mcp/tools.md): The MCP tools your agent can call.
- [Agent Skills](https://docs.postbase.so/mcp/skills.md): Teach Claude Code, Cursor, Codex and other coding agents to post with Postbase.
- [Authentication](https://docs.postbase.so/api/authentication.md): Authenticate REST API requests with an API key.
- [Posts](https://docs.postbase.so/api/posts.md): Create, check, edit, retry and cancel posts.
- [Channels](https://docs.postbase.so/api/channels.md): List the connected accounts you can publish to.
- [Media](https://docs.postbase.so/api/media.md): List and add the images and videos you can attach to posts.
- [Analytics](https://docs.postbase.so/api/analytics.md): How your published posts performed, per channel.
- [Webhooks](https://docs.postbase.so/api/webhooks.md): Get a signed request when a post publishes or fails, or a channel needs reconnecting.
- [Check a key](https://docs.postbase.so/api-reference/account/check-a-key.md): The workspace this key acts for.
- [List channels](https://docs.postbase.so/api-reference/channels/list-channels.md)
- [List posts](https://docs.postbase.so/api-reference/posts/list-posts.md)
- [Create a post](https://docs.postbase.so/api-reference/posts/create-a-post.md): Save a draft, or schedule a post or thread. Send an Idempotency-Key so a retry can't post twice.
- [Get a post](https://docs.postbase.so/api-reference/posts/get-a-post.md): The post and each channel's status, live URL, error and latest metrics.
- [Edit a post](https://docs.postbase.so/api-reference/posts/edit-a-post.md): Edit or reschedule a draft or scheduled post. Only the fields you send change; scheduled_at null turns it into a draft.
- [Cancel a post](https://docs.postbase.so/api-reference/posts/cancel-a-post.md): Stop a scheduled post; it goes back to being a draft.
- [Retry a post](https://docs.postbase.so/api-reference/posts/retry-a-post.md): Send the post again to the channels where it failed. Channels that published are left alone.
- [List media](https://docs.postbase.so/api-reference/media/list-media.md)
- [Add media from a URL](https://docs.postbase.so/api-reference/media/add-media-from-a-url.md): Download a file from a public https link into the media library.
- [Get analytics](https://docs.postbase.so/api-reference/analytics/get-analytics.md): Published posts in a date range with each channel's latest metrics, plus totals for the whole range.
- [List webhooks](https://docs.postbase.so/api-reference/webhooks/list-webhooks.md)
- [Add a webhook](https://docs.postbase.so/api-reference/webhooks/add-a-webhook.md): Register an https endpoint. The signing secret is returned in this response only.
- [List deliveries](https://docs.postbase.so/api-reference/webhooks/list-deliveries.md): An endpoint's recent deliveries, newest first.
- [Delete a webhook](https://docs.postbase.so/api-reference/webhooks/delete-a-webhook.md)
- [Send a test event](https://docs.postbase.so/api-reference/webhooks/send-a-test-event.md): Send a webhook.test event now and report the response. Not retried.
- [Postpublished](https://docs.postbase.so/api-reference/postpublished.md): The post went out on every channel.
- [Postpartial](https://docs.postbase.so/api-reference/postpartial.md): The post went out on some channels and failed on others (no more automatic retries).
- [Postfailed](https://docs.postbase.so/api-reference/postfailed.md): The post failed on every channel (no more automatic retries).
- [Channelneeds reconnect](https://docs.postbase.so/api-reference/channelneeds_reconnect.md): A channel lost access (revoked or expired) and needs reconnecting in Postbase.
- [Installation](https://docs.postbase.so/self-hosting/installation.md): Run your own Postbase.
- [Configuration](https://docs.postbase.so/self-hosting/configuration.md): Environment variables and provider setup.
- [Development](https://docs.postbase.so/contributing/development.md): Contribute to Postbase.

## OpenAPI Specs

- [openapi](/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.