# PostlyBee

> Build social publishing workflows with the PostlyBee Public API and MCP server.

- [PostlyBee Public API](https://docs.postlybee.com/public-api.md): Create posts, upload media, discover connected accounts, and automate social publishing.
- [Quickstart](https://docs.postlybee.com/quickstart.md): Authenticate, discover a connected account, and schedule your first post.
- [Authentication](https://docs.postlybee.com/essentials/authentication.md): Authenticate REST API requests with a workspace Bearer token.
- [Create posts](https://docs.postlybee.com/essentials/posting.md): Understand destinations, scheduling, threads, media, and provider settings.
- [Error handling](https://docs.postlybee.com/essentials/error-handling.md): Handle validation, authentication, plan, throttling, and server failures.
- [Rate limits](https://docs.postlybee.com/essentials/rate-limits.md): Understand the one-hour workspace limit for posts and media uploads.
- [MCP overview](https://docs.postlybee.com/mcp/overview.md): Connect AI clients to PostlyBee through Streamable HTTP and OAuth 2.1.
- [Connect MCP clients](https://docs.postlybee.com/mcp/clients.md): Configure Claude Code, Cursor, and other Streamable HTTP clients.
- [Node.js SDK](https://docs.postlybee.com/sdks/node.md): Use the official PostlyBee package from Node.js and TypeScript.
- [API reference overview](https://docs.postlybee.com/api-reference/overview.md): Conventions shared by every PostlyBee Public API endpoint.
- [Upload media](https://docs.postlybee.com/api-reference/media/upload-media.md): Upload an image or video and receive the media object used when creating a post.
- [Upload media from URL](https://docs.postlybee.com/api-reference/media/upload-media-from-url.md): Import an image or MP4 video from a public HTTPS URL into the workspace media library.
- [Generate a video](https://docs.postlybee.com/api-reference/media/generate-a-video.md): Generate a video with an enabled workspace generator and save it to the media library.
- [Run a video helper function](https://docs.postlybee.com/api-reference/media/run-a-video-helper-function.md): Run an exposed helper function for a video generator, such as listing available voices.
- [Find the next posting slot](https://docs.postlybee.com/api-reference/utilities/find-the-next-posting-slot.md): Return the next free UTC time from the posting schedule of a connected account.
- [Check API connection](https://docs.postlybee.com/api-reference/utilities/check-api-connection.md): Verify that the bearer token resolves to an active workspace.
- [List posts](https://docs.postlybee.com/api-reference/posts/list-posts.md): List workspace posts within an inclusive UTC date range.
- [Create posts](https://docs.postlybee.com/api-reference/posts/create-posts.md): Create drafts, scheduled posts, immediate posts, or social threads for one or more connected accounts.
- [Update post settings](https://docs.postlybee.com/api-reference/posts/update-post-settings.md): Merge provider-specific settings into a queued post or draft before it is published.
- [Delete a post](https://docs.postlybee.com/api-reference/posts/delete-a-post.md): Delete the complete post group associated with a root post ID.
- [List connected accounts](https://docs.postlybee.com/api-reference/accounts/list-connected-accounts.md): List the social accounts available for publishing in the authenticated workspace.

## OpenAPI Specs

- [openapi](/api-reference/openapi.json)