# PostMesh

> How PostMesh works: write one post, check it against every network's rules, and publish or schedule it to 12 social networks.

- [PostMesh docs](https://postmesh.app/docs/index.md): Write one post, check it against every network's rules, and publish or schedule it to 12 social networks. Guides, limits and the MCP reference.
- [Quickstart: your first post to every network](https://postmesh.app/docs/quickstart.md): Create a PostMesh account, connect your social accounts and publish your first post to several networks at once, step by step, in a few minutes.
- [Connect Instagram, TikTok, YouTube and more](https://postmesh.app/docs/connect-accounts.md): How to connect each social network to PostMesh with its official sign-in, what each one needs, and how to reconnect an account whose login expired.
- [Plans, trial and billing](https://postmesh.app/docs/plans-and-billing.md): PostMesh plans compared: Creator, Growth and Pro, monthly or yearly, with a 7-day trial. Account limits, what every plan includes and how to cancel.
- [Different captions for each social network](https://postmesh.app/docs/captions-per-network.md): Write one caption for every network, then give X, LinkedIn or any other network its own version. Every network's caption limit in one table.
- [Schedule posts to every network](https://postmesh.app/docs/schedule-posts.md): Schedule one post to every network, from Instagram and TikTok to Bluesky and Discord, up to 12 months ahead, from the composer or your AI assistant.
- [Pre-flight checks before every post](https://postmesh.app/docs/pre-flight-checks.md): What PostMesh checks before it sends a post: caption length, hashtags, file type and size, video length, aspect ratio, TikTok settings and Reddit rules.
- [Drafts and bulk CSV import](https://postmesh.app/docs/drafts-and-csv-import.md): Save 200 to unlimited drafts by plan, and import posts in bulk from a CSV with content, platforms and scheduled_at columns. Drafts never publish on their own.
- [Send a post to your client for approval](https://postmesh.app/docs/client-approvals.md): Send a post for your client's approval with a review link. They approve or ask for changes on each network, and nothing posts until every network is approved.
- [Why a post failed and how to retry it](https://postmesh.app/docs/fix-a-failed-post.md): Why a scheduled or published post failed on a network, what each common reason means, and how Retry sends the post again only to the accounts that failed.
- [Supported networks and what each takes](https://postmesh.app/docs/networks.md): The 12 networks PostMesh publishes to, from Instagram and TikTok to Bluesky and Discord, what each one accepts, and a link to its full page of limits.
- [Post to Discord with a channel webhook](https://postmesh.app/docs/discord.md): Post to a Discord channel, forum or thread through a channel webhook: how to make one, forum post titles, pings and how long posts are split.
- [Post to social media from Claude, Cursor and Codex (MCP)](https://postmesh.app/docs/mcp-setup.md): Connect PostMesh's remote MCP server to Claude, Cursor, Codex or any MCP client, then schedule and publish posts by asking in plain words.
- [MCP tool reference](https://postmesh.app/docs/mcp-tools.md): All 31 tools on the PostMesh MCP server, with their parameters: schedule_post, publish_post_now, validate_post, list_scheduled_posts and more.
- [API keys](https://postmesh.app/docs/api-keys.md): Create, scope and revoke PostMesh API keys for the MCP server. Keys are shown once, stored hashed, and can only do what their scopes allow.
- [Webhooks](https://postmesh.app/docs/webhooks.md): Signed webhook events when PostMesh schedules, publishes or fails a post, holds one, or needs an account reconnected, with retries and replay.
- [AI Agent: draft posts for every network](https://postmesh.app/docs/ai-agent.md): PostMesh's AI Agent drafts a post for each network, checks it against each network's limits, reads links you share and asks before anything is published.
- [Clip Factory: short clips from a YouTube video](https://postmesh.app/docs/clip-factory.md): Turn a YouTube video into suggested vertical clips with Clip Factory, or join your call-to-action video to the opening seconds of several videos at once.
- [Analytics for posts sent from PostMesh](https://postmesh.app/docs/analytics.md): See likes, comments, views and other metrics for posts you sent from PostMesh, over 7 to 90 days, with insights on what to post next and a CSV export.
- [Export your data or delete your account](https://postmesh.app/docs/data-and-privacy.md): Export your PostMesh drafts, history, connected accounts and settings, disconnect a network, or delete your account and its data.
- [Who you are](https://postmesh.app/docs/api-reference/accounts/who-you-are.md): The person the key belongs to, the key's scopes, the plan and this month's usage.
- [List connected accounts](https://postmesh.app/docs/api-reference/accounts/list-connected-accounts.md): Every social account you connected, with whether it can post right now.
- [List posts](https://postmesh.app/docs/api-reference/posts/list-posts.md): Your posts a page at a time: newest first, or soonest first for scheduled ones. Pass next_cursor as cursor for the next page.
- [Create a post](https://postmesh.app/docs/api-reference/posts/create-a-post.md): Posts now, or schedules the post when scheduled_at is set. Every network's rules are checked first; a post that breaks one is refused with 400 and nothing is sent. With an API key in approval mode the post waits for you in PostMesh instead.
- [Get a post](https://postmesh.app/docs/api-reference/posts/get-a-post.md): One post, with all of its text and each account's outcome.
- [Delete a post from PostMesh](https://postmesh.app/docs/api-reference/posts/delete-a-post-from-postmesh.md): Removes the post from your history for good. Anything already live on a network stays there. Cancel a scheduled post first.
- [Change a scheduled post](https://postmesh.app/docs/api-reference/posts/change-a-scheduled-post.md): Changes the text, accounts, settings or time of a post still waiting to go out.
- [Cancel a scheduled post](https://postmesh.app/docs/api-reference/posts/cancel-a-scheduled-post.md): Stops a scheduled post before it goes out.
- [Retry a failed post](https://postmesh.app/docs/api-reference/posts/retry-a-failed-post.md): Sends a failed post again to the accounts it failed on, or the ones you name.
- [Get a post's numbers](https://postmesh.app/docs/api-reference/analytics/get-a-posts-numbers.md): Views, likes, comments and shares for one post on each network, with how they changed.
- [Get analytics](https://postmesh.app/docs/api-reference/analytics/get-analytics.md): Your posts' numbers across every network, as the Analytics page shows them.
- [List drafts](https://postmesh.app/docs/api-reference/drafts/list-drafts.md): Your saved drafts, most recently changed first.
- [Create a draft](https://postmesh.app/docs/api-reference/drafts/create-a-draft.md): Saves a draft. Nothing is sent until you post it.
- [Get a draft](https://postmesh.app/docs/api-reference/drafts/get-a-draft.md): One draft, with links to view its files.
- [Delete a draft](https://postmesh.app/docs/api-reference/drafts/delete-a-draft.md): Removes the draft for good.
- [Change a draft](https://postmesh.app/docs/api-reference/drafts/change-a-draft.md): Changes the fields you send and keeps the rest.
- [List media](https://postmesh.app/docs/api-reference/media/list-media.md): The files in your media library, newest first.
- [Add a file](https://postmesh.app/docs/api-reference/media/add-a-file.md): Adds a file to your media library: send `path` once you uploaded it to a link from POST /media/uploads (it is checked to be the image or video it says), or `url` for PostMesh to download it. Put the answer's media_ref in a post's media.
- [Get a file](https://postmesh.app/docs/api-reference/media/get-a-file.md): One file in your media library.
- [Get an upload link](https://postmesh.app/docs/api-reference/media/get-an-upload-link.md): A link to PUT one file to, up to 1 GB. Then send its path to POST /media.

## OpenAPI Specs

- [openapi](/docs/openapi.json)


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