Does Buffer have an API?
Yes! Buffer does have an API. Let's chat about it. đ
Bufferâs API Beta makes it possible for anyone on any Buffer plan to connect Buffer with other tools so you can:
- automate tasks,
- build custom workflows, and
- experiment with AI assistantsâno advanced coding required!
This guide focuses on practical, everyday automations using popular tools. If youâre looking for deeper technical documentation, youâll find that in our developer docs.
Bufferâs API is in Beta, which means features may be limited while we test and improve the experience.
Notes:
- The API Key is user-based, not organization-based, and can only be generated by organization owners at this time.
- API Keys are personal and won't be visible to the rest of the team.
- Organization members who attempt to create a key will be prompted to switch to an organization where they're an owner.
- Currently, Bufferâs public API is focused on post creation and idea management. At this time, analytics data is not available via the API.
â Paid accounts can generate up to five API keys. Free accounts are limited to one. API usage is shared across all your personal API keys.
In this article:
Why use workflows and automations with Buffer?
Workflows and automations help Buffer work seamlessly with the tools you already use, so repetitive tasks can happen automatically instead of manually.
Theyâre especially helpful if you want to:
- Save time by reducing copy-and-paste work
- Automatically turn ideas, files, or submissions into Buffer posts or ideas
- Keep content flowing into Buffer from one central place
- Improve or format posts before theyâre scheduled (including using AI)
You donât need to start big. You can begin with one simple trigger that creates a post or idea in Buffer, then add more steps over time as your needs grow.
If you regularly move content into Buffer by hand or wish posting could feel more effortless, workflows and automations are a great place to start.
Before you start
To use Bufferâs API with any workflow or MCP (AI assistant) tool, youâll need:
â A Buffer account with a verified email address. API access requires email verification. If you haven't verified your email yet, check your inbox for a verification email from Buffer, or head to your account settings to resend it.
â Access to the channels you want to use.
â Your Buffer API Key.
â An account with the tool you want to connect (like Zapier or Make).
How to find your Buffer API Key
To connect Buffer with automation tools or AI assistants, youâll first need to generate your personal API key.
- Head to https://publish.buffer.com/settings/api
- Click Generate API Key.
Once generated, you can copy this key and paste it into the tool youâre connecting to Buffer.
How to confirm it worked
After clicking Generate API Key, you should see a new key appear on the page. If you donât see one:
- Refresh the page
- Make sure youâre in the correct organization
đ Keep your API Key secure
Your API key works like a password for connecting other tools to Buffer. Only share it with trusted apps and services. If you think itâs been exposed, you can return to this page and generate a new one.
đ Note: If you need to revoke a key, you can delete it from this page and generate a new one.
How many API keys can I create?
The number of API keys you can create depends on your Buffer plan. If you try to create a new API key or OAuth client after reaching your plan's limit, you'll see a prompt to upgrade your plan. Click See upgrade options to view available plans and unlock more keys. You can manage your plan from your billing settings.
đ Note: Currently, only the organization owner on a Team plan can create API keys. In the future, all team members will be able to create keys up to the plan limit.
| Plan** | API Keys | App Clients |
|---|---|---|
| Free | 1 | 1 |
| Essentials | 3 | 3 |
| Team | 5 | 5 |
**Are you an app developer building out an integration for multiple users and need higher rate limits? Please get in touch with our developer support team [developersupport@buffer.com] and provide a detailed overview of what you're building.
API token expiration and notifications
API tokens (API keys and OAuth app credentials) expire 30 days from the date they were created. To help you stay on top of your integrations, Buffer sends automatic notifications at three points:
- Token created â You'll receive a confirmation when a new token is generated.
- Token expiring soon â You'll get a heads-up before your token expires so you have time to regenerate it without disrupting your integrations.
- Token expired â If a token expires, you'll be notified so you can take action right away.
API keys can expire based on their configured expiration date. If you see an expiration notice next to one of your keys, here's how to get back up and running:
- In your Developer Dashboard, find the expired key.
- Click the three-dot menu (âŻ) next to the expired key.
- Select Regenerate.
- Copy the new key â it will only be shown once.
- Update the new key in every place you've used the old one: any integrations, scripts, automation tools, or third-party apps.
â ď¸ Note: Simply regenerating the key won't automatically update it in your other tools â you'll need to replace it manually wherever the old key was used.
If you're not sure where you've used the key, check any automation workflows (such as Make.com, n8n, or Zapier) and any custom scripts or apps that connect to Buffer via API.
API token notifications
Buffer automatically sends email notifications to help you stay on top of your API token's status:
- Token created â You'll receive a confirmation email when a new API token is successfully generated, along with a reminder to store it securely.
- Token expiring soon â You'll be emailed 7 days before your token is set to expire, giving you time to regenerate it before your integrations are affected. API tokens expire 30 days after they were created.
- Token expired â If a token expires without being regenerated, you'll receive an email letting you know that your API access has stopped working, with a direct link to generate a new token in your Developer Settings.
Understanding your API usage
Buffer's Developer Dashboard shows your API usage broken down by client, so you can see exactly how much of your rate limit each key or integration is using.
- Personal API keys: Your personal keys' usage is shown together in one group.
- App clients: Each app client (third-party integration or custom app) shows its own usage separately.
How rate limits work:
- Rate limits are applied per client â each personal key and each app client has its own limit, independent of your other clients.
- Rate limit windows are rolling (not fixed to an hour or day boundary) â they continuously slide forward.
- The rate limit for a client is based on the plan of the organization where the client was created.
You can view current usage and limits for each client directly in the Developer Dashboard.

Supported functions & social channels
Functions
Posts - Create posts with: text, media (images & videos), and channel-specific features (like first comment and threaded posts).
Ideas - Create text and image-only ideas.
Fetching data - In addition to the actions above, Buffer's API also supports several queries, meaning you can fetch data from your Buffer account programmatically. These include things like retrieving your profiles, scheduled posts, sent posts, and more. You can browse all available queries in the Buffer API reference.
đ Notes:
- At this time, it is not possible to Edit posts within Buffer's API. We hope to support this function soon!
- Video thumbnails: If you're posting a video via URL and don't include a thumbnail, Buffer will automatically generate one for you.
Supported social networks
At this time, our API supports posting to Instagram, Threads, LinkedIn, X/Twitter, Facebook, TikTok, Google Business Profiles, Mastodon, YouTube, Pinterest, and Bluesky.
đ Note: For TikTok, make sure your media stays available at the provided URL until your post publishes, not just at the time of scheduling. Moving or deleting it beforehand may cause your post to fail.
Workflow Automations (No Coding Required)
Workflow tools let you create automations using visual builders and simple logic like:
When this happens â Do that in Buffer
These workflows can be very simple (one trigger â one action) or more advanced, with multiple steps that transform, filter, or enhance content before anything is sent to Buffer.
Common workflow tools
You can connect Buffer with:
- Zapier
- Make
- IFTTT
- n8n
Each tool works a little differently, but the overall setup usually follows the same pattern: choose a trigger, connect Buffer, and define what should happen next.
Example workflow: Automatically share new blog posts to Buffer
Scenario (Given / When / Then)
Given you publish a new article on your website
When a new post appears in your blog feed
Then Buffer creates a social post and adds it to your queue
Step-by-step setup (general flow)
-
Choose a trigger.
Example: âNew RSS feed itemâ or âNew blog post publishedâ
Connect Buffer as the action app.
Log into Buffer when prompted and enter your API key if required
Set the action.
Action: Create a post in Buffer
Choose:
- The channel
- The post text (often the article title + link)
- Whether to publish immediately or add to the queue
-
Test the workflow.
Use the toolâs Test or Run once option and confirm a post appears in Buffer
More advanced workflows with logic, filters, and AI
Tools like n8n let you build more powerful workflows with extra steps between the trigger and Buffer.
These workflows can include:
- Logic (only continue if certain conditions are met)
- Transformations (reformatting or combining content)
- AI steps (rewriting text, generating captions, or enriching data)
Instead of sending content directly to Buffer, you can shape and improve it first.
Workflow ideas you can build
Here are some real-world examples of how multi-step workflows can create posts or ideas in Buffer:
| Goal | Trigger | What happens in the workflow | Result in Buffer |
|---|---|---|---|
| Capture content ideas from planning docs | New item in Notion database | Pulls the title + content and formats it | Creates a Buffer Idea for later review |
| Turn submissions into polished posts | Form submission received | AI step rewrites or enhances the copy | Creates a ready-to-publish post |
| Share new videos with captions | New file added in Google Drive folder | AI generates a caption for the video | Creates a post with video + caption |
| Curate industry news | New RSS feed item | Filters by keywords and enriches the content | Creates a Buffer Idea instead of auto-posting |
| Batch content on a schedule | Scheduled time (e.g. weekly) | Pulls from multiple sources and formats content | Creates scheduled posts in Buffer |
These examples can be simple or complex depending on how many steps you include between the trigger and Buffer.
How to verify your workflow is working
After turning your workflow on:
-
Trigger the event (add a Notion item, upload a file, submit a form, etc.)
Check that:
- A post or idea appears in Buffer
- The correct channel is selected
- The text, links, or media look right
- If nothing happens:
- Double-check your API key
- Make sure the workflow is switched ON
- Confirm the trigger app is updating as expected
Using MCP & AI assistants (âvibe codingâ)
MCP tools let AI assistants connect to Buffer so you can create or manage posts using natural language.
You might use tools like Cursor, Zapier, n8n, Claude or Raycast to build small apps or automations that talk to Bufferâs API.
Note: ChatGPT and Perplexity are not available yet, but they're coming soon!
To connect MCP tools:
- Head to https://publish.buffer.com/settings/integrations
- Select an MCP from the list.
- Click + Generate API Key if you haven't generated an API Key yet. Otherwise, you should see Setup steps based on the MCP you've selected.

⨠Tip: When you connect a new integration you'll see prompts under Try It Out to help get you going! These may include things like, "Show me my upcoming scheduled Buffer posts for the week" or "List all my Buffer channels."
Example MCP scenario: âPost this idea to LinkedInâ
Given you have an AI assistant connected to Buffer
When you say: âShare this as a LinkedIn post in Buffer tomorrow at 9amâ
Then the assistant sends that request to Buffer using your API access
General MCP setup steps
-
Add Buffer to your MCP tool
Look for âAdd APIâ or âAdd integrationâ and enter your Buffer API key.
-
Tell the AI what itâs allowed to do
Example: âYou can create and schedule posts in Buffer.â
-
Try a simple request
âCreate a draft post in Buffer that says âHello world.ââ
-
Confirm inside Buffer
Check that the post appears as expected.
How to verify MCP is working
-
Ask the AI to create a draft post
Look in Buffer to confirm:
- The post exists
- The text matches your request
- Itâs assigned to the correct channel
If it fails:
- Recheck your API key.
- Make sure your Buffer permissions allow posting.
- Look for error messages in your MCP toolâs activity or logs.
Handling errors & edge cases
| Issue | What to check |
|---|---|
| Can't generate an API key / option not appearing | Make sure your Buffer account email is verified. Head to Settings â Account and look for a verification prompt, or check your inbox for a verification email from Buffer. |
| Post not appearing in Buffer | Is your API key correct? Is your workflow turned on? |
| Posted to wrong channel | Is the correct channel selected in setup? |
| AI says it posted but nothing shows | API access expired or permissions too limited |
| Duplicate posts | Workflow triggered more than once |
| Authorization error |
Check to make sure { "mcpServers": { "buffer": { "command": "npx", "args": [ "-y", "mcp-remote", "https://mcp.buffer.com/mcp", "--header", "Authorization: Bearer API_KEY" // <-- The 'Bearer' prefix here ] } } } |
| Video not attaching / media URL error | The media URL must be publicly accessible. If it returns Cross-Origin Resource Policy (CORP) headers or requires authentication, the API can't retrieve the file and will return an error. Open the URL in an incognito tab to confirm it's accessible. If it doesn't load there, it won't work in the API either. |
| Hitting API usage limits unexpectedly | Head to your API settings within Buffer and check the usage breakdown by App Client to see which integration is consuming the most capacity. |
| Claude MCP integration not working | Make sure Node.js version 18 or higher is installed. If you have multiple versions installed, confirm that Claude Desktop is using version 18+ instead of an older version. |
FAQ
How many API keys can I have?
Paid accounts can generate up to five API keys. Free accounts are limited to one key.
Having multiple keys is useful if you're connecting Buffer to several tools or workflows and want to keep access separate. For example, one key for Zapier and another for your Claude MCP setup.
What happens if I downgrade my plan?
If you downgrade from a paid plan to the Free plan while you have multiple API keys, all API keys except your original (earliest-created) key will be automatically revoked. You'll receive a notification when this happens so you can update any integrations that use the revoked keys before they stop working.
Does API usage count separately for each key?
No. API usage is shared across all your personal API keys. Having multiple keys doesn't give you more API capacity; it just gives you more flexibility in how you manage access.
How do I see which tools are using my API quota?
Head to Settings â API and look for the API Usage section. You'll see a breakdown of API activity by App Client â so if you have Buffer connected to Zapier, Make, and a Claude MCP, you can see how much each one is using.
This is handy if you're approaching your usage limits and want to understand where the activity is coming from.
How do I generate a new API key?
- Head to publish.buffer.com/settings/api
- Click + New API Key
- Optionally, give your key a name (e.g. "Zapier" or "n8n workflow") so you can tell them apart later
- Choose an expiration period â 7 days, 30 days, 60 days, 90 days, or 1 year
- Click Generate API Key, then copy it and paste it into the tool you're connecting
Once generated, your key won't be shown again in full â copy it before closing the dialog.

Can I name my API keys?
Yes! When generating a key, you can give it an optional name (like "Make automation" or "Claude MCP"). This makes it easier to manage multiple keys and know which one to revoke if something stops working.
Do API keys expire?
Yes â when generating a key, you choose how long it stays valid:
- 7 days
- 30 days (default)
- 60 days
- 90 days
- 1 year
Make sure to renew or replace keys before they expire to avoid any disruption to connected workflows.
⨠Tip: Setting a longer expiration (like 1 year) is a good choice for stable, long-running integrations.

How do I revoke or delete an API key?
On the API settings page, click the ⎠(three-dot menu) next to any key to manage or delete it. If you think a key has been compromised, delete it and generate a new one straight away.
â ď¸ Generating a new key in place of an existing one will immediately revoke the old key â any tools or scripts using it will stop working until you update them with the new key.
How do I keep my API keys secure?
Treat each API key like a password. A few best practices:
- Give each key a descriptive name so you always know what it's connected to
- Use a separate key per integration so you can revoke one without disrupting others
- Delete any keys you're no longer using
- Choose an expiration window that matches how long you expect to use the integration
Want to go deeper? This guide focuses on simple, everyday setups. If you want to build more advanced or custom integrations using Bufferâs API, our developer documentation walks through everything step by step.