# Postpone API Docs

> A documentation for the Postpone API.

## Documentation Sets

- [Postpone API Docs - Full Documentation](https://developers.postpone.app/llms-full.txt): This is the full documentation for the Postpone API.

## Getting Started

- [Introduction](https://developers.postpone.app/raw/getting-started.md): Create scripts and automations using Postpone's GraphQL API.
- [Authentication](https://developers.postpone.app/raw/getting-started/authentication.md): Learn how to authenticate with Postpone's GraphQL API using personal API keys.
- [Error Handling](https://developers.postpone.app/raw/getting-started/errors.md): Understanding and handling errors in the Postpone GraphQL API.
- [GraphQL Types](https://developers.postpone.app/raw/getting-started/types.md): Core GraphQL types and their structure in the Postpone API.
- [Rate Limits](https://developers.postpone.app/raw/getting-started/rate-limits.md): Understand Postpone's API rate limits and how to handle them in your applications.
- [AI & MCP](https://developers.postpone.app/raw/getting-started/ai-mcp.md): Connect AI agents to Postpone with the Model Context Protocol (MCP) server, using OAuth or a Bearer token.
- [Docs MCP Server](https://developers.postpone.app/raw/getting-started/docs-mcp.md): Give your AI coding assistant direct access to the Postpone API documentation through a Model Context Protocol (MCP) server.
- [API Changelog](https://developers.postpone.app/raw/getting-started/changelog.md): Notable additions and changes to the Postpone API.

## Queries

- [User](https://developers.postpone.app/raw/queries/user.md): Query the authenticated user's profile, account details, and plan information.
- [Social Accounts](https://developers.postpone.app/raw/queries/social-accounts.md): Query connected social media accounts across all platforms.
- [Content Library](https://developers.postpone.app/raw/queries/content-library.md): Query and filter media files from your Postpone Content Library.

## Scheduling Posts

- [Introduction](https://developers.postpone.app/raw/scheduling-posts.md): Learn how to schedule posts across multiple social media platforms using the Postpone API.
- [Managing Posts](https://developers.postpone.app/raw/scheduling-posts/example-mutations.md): Common GraphQL mutations you can execute against the Postpone API to manage your posts.
- [Post Tags](https://developers.postpone.app/raw/scheduling-posts/post-tags.md): Learn how to query post tags to organize your scheduled content using the Postpone API.
- [Retrieving Posts](https://developers.postpone.app/raw/scheduling-posts/retrieving-posts.md): Learn how to query and retrieve your scheduled and published posts across all platforms using the Postpone API.
- [Next Scheduled Dates](https://developers.postpone.app/raw/scheduling-posts/next-scheduled-dates.md): Query the next available posting slot from each social account's schedule.
- [Uploading Media](https://developers.postpone.app/raw/scheduling-posts/uploading-media.md): Upload media to your Content Library from a URL or from a local file.
- [Video Covers](https://developers.postpone.app/raw/scheduling-posts/video-covers.md): Set the cover image (thumbnail) of a video from a frame of the video or from your own image.
- [All Platforms](https://developers.postpone.app/raw/scheduling-posts/platforms.md): Learn how to schedule posts to specific social media platforms using the Postpone API
- [Reddit](https://developers.postpone.app/raw/scheduling-posts/platforms/reddit.md): Schedule images, vieos, links, and text posts to multiple subreddits with media attachments
- [X/Twitter](https://developers.postpone.app/raw/scheduling-posts/platforms/twitter.md): Schedule tweets and threads with media attachments
- [Instagram](https://developers.postpone.app/raw/scheduling-posts/platforms/instagram.md): Schedule feed posts, Reels, Stories, and carousels to Instagram
- [Facebook](https://developers.postpone.app/raw/scheduling-posts/platforms/facebook.md): Schedule posts, reels, and stories to Facebook pages
- [Threads](https://developers.postpone.app/raw/scheduling-posts/platforms/threads.md): Schedule posts and threads with media attachments to Meta's Threads platform
- [Bluesky](https://developers.postpone.app/raw/scheduling-posts/platforms/bluesky.md): Schedule posts and threads with media attachments to Bluesky
- [TikTok](https://developers.postpone.app/raw/scheduling-posts/platforms/tiktok.md): Schedule video content to TikTok
- [YouTube Shorts](https://developers.postpone.app/raw/scheduling-posts/platforms/youtube.md): Schedule short-form video content to YouTube
- [LinkedIn](https://developers.postpone.app/raw/scheduling-posts/platforms/linkedin.md): Schedule professional posts to LinkedIn profiles and pages
- [Pinterest](https://developers.postpone.app/raw/scheduling-posts/platforms/pinterest.md): Schedule pins to Pinterest boards
- [Mastodon](https://developers.postpone.app/raw/scheduling-posts/platforms/mastodon.md): Schedule posts and threads to Mastodon and other ActivityPub servers
- [Tumblr](https://developers.postpone.app/raw/scheduling-posts/platforms/tumblr.md): Schedule posts to Tumblr blogs
- [Telegram](https://developers.postpone.app/raw/scheduling-posts/platforms/telegram.md): Schedule posts to Telegram channels and groups

## Analytics

- [Post Time Series Metrics](https://developers.postpone.app/raw/analytics/post-time-series-metrics.md): Retrieve time-series analytics data for your social media posts grouped by date.
- [Aggregate Post Metrics](https://developers.postpone.app/raw/analytics/aggregate-post-metrics.md): Retrieve aggregated analytics metrics for your social media posts across a time period.
- [Aggregate Social Account Post Metrics](https://developers.postpone.app/raw/analytics/aggregate-social-account-post-metrics.md): Retrieve aggregated post metrics for multiple social accounts, broken down by account.
- [Post Tag Metrics](https://developers.postpone.app/raw/analytics/post-tag-metrics.md): Retrieve aggregated analytics metrics for your posts grouped by post tags.
- [Multi-Platform Analytics Submissions](https://developers.postpone.app/raw/analytics/multi-platform-analytics-submissions.md): Retrieve and search individual post submissions across multiple platforms with detailed metrics.
- [Platform Metrics](https://developers.postpone.app/raw/analytics/platform-metrics.md): Available analytics metrics for each social media platform.
- [Introduction](https://developers.postpone.app/raw/analytics.md): Query analytics data and performance metrics for your social media posts.

## MCP Server

This site exposes a Model Context Protocol (MCP) server over streamable HTTP at https://developers.postpone.app/mcp.

- [Postpone API Docs](https://developers.postpone.app/mcp): Streamable HTTP endpoint — connect an MCP client to this URL to call the tools, resources and prompts exposed by this site.