# Buffer API

> Connect Buffer to your agents, automation tools, or build something entirely new.

API Endpoint: https://api.buffer.com
Authentication: Bearer token via Authorization header

## Guides

- [Introduction](https://developers.buffer.com/guides/introduction.md)
- [Quick Start](https://developers.buffer.com/guides/getting-started.md)
- [Authentication](https://developers.buffer.com/guides/authentication.md)
- [Your First Post](https://developers.buffer.com/guides/your-first-post.md)
- [GraphQL for REST Devs](https://developers.buffer.com/guides/graphql-intro.md)
- [REST API Migration](https://developers.buffer.com/guides/rest-migration.md)
- [Data Model](https://developers.buffer.com/guides/data-model.md)
- [Posts & Scheduling](https://developers.buffer.com/guides/posts-and-scheduling.md)
- [Ideas](https://developers.buffer.com/guides/ideas.md)
- [Hosting Media](https://developers.buffer.com/guides/hosting-media.md)
- [Post Metrics](https://developers.buffer.com/guides/post-metrics.md)
- [API Standards](https://developers.buffer.com/guides/api-standards.md)
- [Error Handling](https://developers.buffer.com/guides/error-handling.md)
- [Rate Limits](https://developers.buffer.com/guides/api-limits.md)
- [Pagination](https://developers.buffer.com/guides/pagination.md)
- [Buffer CLI](https://developers.buffer.com/guides/cli.md)
- [Integrations](https://developers.buffer.com/guides/integrations.md)
- [Zapier](https://developers.buffer.com/guides/integrations/zapier.md)
- [Claude](https://developers.buffer.com/guides/integrations/claude.md)
- [MCP](https://developers.buffer.com/guides/integrations/mcp.md)
- [Cursor](https://developers.buffer.com/guides/integrations/cursor.md)
- [n8n](https://developers.buffer.com/guides/integrations/n8n.md)
- [Raycast](https://developers.buffer.com/guides/integrations/raycast.md)
- [ChatGPT](https://developers.buffer.com/guides/integrations/chatgpt.md)
- [Notion](https://developers.buffer.com/guides/integrations/notion.md)
- [Perplexity](https://developers.buffer.com/guides/integrations/perplexity.md)
- [Antigravity](https://developers.buffer.com/guides/integrations/antigravity.md)
- [Manus](https://developers.buffer.com/guides/integrations/manus.md)

## Examples

- [Aggregate Post Metrics](https://developers.buffer.com/examples/aggregate-post-metrics.md): Aggregate normalized post metrics across a window of sent posts, without paginating through individual posts. Available for personal workflows and automations only, using a personal API key.
- [Create Draft Post](https://developers.buffer.com/examples/create-draft-post.md): Draft posts can be created using the createPost mutation with the `saveToDraft` argument set to `true`. When saving a post as a draft, there are several required arguments:
- [Create Idea](https://developers.buffer.com/examples/create-idea.md): Create an idea post for a specified Organization, using the provided content.
- [Create Image Post](https://developers.buffer.com/examples/create-image-post.md): Creating a post with an image works in the same way as creating a text post, with the addition of the `assets` argument. `assets` is an ordered list where each entry specifies exactly one of `image`, `video`, `document`, or `link` — for an image post, pass an `image` entry with the URL you want to attach.
- [Create Instagram Post With User Tags](https://developers.buffer.com/examples/create-instagram-post-with-user-tags.md): User tags let you tag Instagram accounts at a specific point on an image. They are attached per image, on the asset's `metadata.userTags` field - not on the Instagram post metadata - so the same approach works for Instagram posts and stories.
- [Create Scheduled Post](https://developers.buffer.com/examples/create-scheduled-post.md): Scheduled posts can be created using the createPost mutation with the `customScheduled` mode and a `dueAt` timestamp. When creating a scheduled post, there are several required arguments:
- [Create Text Post](https://developers.buffer.com/examples/create-text-post.md): Text posts can be created using the createPost mutation. When creating a post, there are several required arguments:
- [Create Threaded Post](https://developers.buffer.com/examples/create-threaded-post.md): Threaded posts (for example a Twitter/X thread or a Bluesky, Threads, or Mastodon thread) are created with the `createPost` mutation by passing a `thread` array inside the service-specific `metadata`. Each entry in the array is one post in the thread, and they are published in order, each replying to the previous one.
- [Create Video Post](https://developers.buffer.com/examples/create-video-post.md): Creating a post with a video works in the same way as creating a text post, with the addition of a `video` entry in the `assets` array. `assets` is an ordered list where each entry specifies exactly one of `image`, `video`, `document`, or `link` - pass a `video` entry with the URL you want to attach.
- [Get Channel](https://developers.buffer.com/examples/get-channel.md): Fetch a single channel by its ID.
- [Get Channels](https://developers.buffer.com/examples/get-channels.md): Fetch all channels for the provided Organization ID.
- [Get Filtered Channels](https://developers.buffer.com/examples/get-filtered-channels.md): Fetch all channels for the provided Organization ID.
- [Get Organizations](https://developers.buffer.com/examples/get-organizations.md): Fetch all of the organizations that belong to the authenticated account.
- [Get Paginated Posts](https://developers.buffer.com/examples/get-paginated-posts.md): Fetch a list of posts with support for pagination.
- [Get Post Metrics](https://developers.buffer.com/examples/get-post-metrics.md): Fetch performance metrics for a single post. Available for personal workflows and automations only, using a personal API key.
- [Get Posts For Channels](https://developers.buffer.com/examples/get-posts-for-channels.md): Fetch a list of posts for a specific set of Channel IDs.
- [Get Posts With Assets](https://developers.buffer.com/examples/get-posts-with-assets.md): Fetch a list of posts along with their associated assets (images, videos, etc.) for a specific set of Channel IDs.
- [Get Posts With Metrics](https://developers.buffer.com/examples/get-posts-with-metrics.md): Fetch a paginated list of sent posts together with their performance metrics. Available for personal workflows and automations only, using a personal API key.
- [Get Quarterly Performance Report](https://developers.buffer.com/examples/get-quarterly-performance-report.md): Roll up a quarter of publishing activity into a single aggregate. Useful for BI exports, board-deck stats, or year-on-year comparisons without paginating through every post.
- [Get Scheduled Posts](https://developers.buffer.com/examples/get-scheduled-posts.md): Fetch a list of posts that are scheduled for future publishing.

## API Reference

- [API Reference](https://developers.buffer.com/reference.md): Complete GraphQL API reference with queries, mutations, and types

## Changelog

- [API Changelog](https://developers.buffer.com/changelog.md): A running log of additions, changes, and deprecations to the Buffer GraphQL API.