Skip to content

buffer.md

Latest commit

 

History

History
138 lines (96 loc) · 3.61 KB

buffer.md

File metadata and controls

138 lines (96 loc) · 3.61 KB

Buffer

Social media scheduling, publishing, and analytics platform for managing multiple social profiles.

Capabilities

Integration Available Notes
API ✓ REST API v1 for profiles, updates, scheduling
MCP - Not available
CLI ✓ buffer.js
SDK - No official SDK; legacy API still supported

Authentication

  • Type: OAuth 2.0 Bearer Token
  • Header: Authorization: Bearer {access_token}
  • Get key: Register app at https://buffer.com/developers/apps then complete OAuth flow
  • Note: Buffer is no longer accepting new developer app registrations; existing apps continue to work. New public API is in development at https://buffer.com/developer-api

Common Agent Operations

Get user info

GET https://api.bufferapp.com/1/user.json

Authorization: Bearer {token}

List connected profiles

GET https://api.bufferapp.com/1/profiles.json

Authorization: Bearer {token}

Get profile posting schedules

GET https://api.bufferapp.com/1/profiles/{profile_id}/schedules.json

Create a scheduled post

POST https://api.bufferapp.com/1/updates/create.json
Content-Type: application/x-www-form-urlencoded

profile_ids[]={profile_id}&text=Your+post+content&scheduled_at=2026-03-01T10:00:00Z

Get pending updates for a profile

GET https://api.bufferapp.com/1/profiles/{profile_id}/updates/pending.json?count=25

Get sent updates for a profile

GET https://api.bufferapp.com/1/profiles/{profile_id}/updates/sent.json?count=25

Publish a pending update immediately

POST https://api.bufferapp.com/1/updates/{update_id}/share.json

Delete an update

POST https://api.bufferapp.com/1/updates/{update_id}/destroy.json

Reorder queue

POST https://api.bufferapp.com/1/profiles/{profile_id}/updates/reorder.json
Content-Type: application/x-www-form-urlencoded

order[]={update_id_1}&order[]={update_id_2}&order[]={update_id_3}

API Pattern

Buffer API v1 uses .json extensions on all endpoints. POST requests use application/x-www-form-urlencoded content type. Array parameters use bracket notation (e.g., profile_ids[]).

Responses include a success boolean for mutation operations.

Key Metrics

Profile Metrics

  • followers - Follower count for connected profile
  • service - Platform name (twitter, facebook, instagram, linkedin, etc.)

Update Metrics (sent updates)

  • statistics.reach - Post reach
  • statistics.clicks - Link clicks
  • statistics.retweets - Retweets/shares
  • statistics.favorites - Likes/favorites
  • statistics.mentions - Mentions

Parameters

Update Create Parameters

  • profile_ids[] - Required. Array of profile IDs to post to
  • text - Required. Post content
  • scheduled_at - ISO 8601 timestamp for scheduling
  • now - Set to true to publish immediately
  • top - Set to true to add to top of queue
  • shorten - Set to true to auto-shorten links
  • media[photo] - URL to photo attachment
  • media[thumbnail] - URL to thumbnail
  • media[link] - URL for link attachment

When to Use

  • Scheduling social media posts across multiple platforms
  • Managing social media content queues
  • Analyzing post performance across channels
  • Automating social media publishing workflows
  • Coordinating team social media activity

Rate Limits

  • 60 authenticated requests per user per minute
  • Exceeding returns HTTP 429
  • Higher limits available by contacting hello@buffer.com

Relevant Skills

  • social-media-calendar
  • content-repurposing
  • social-proof
  • launch-sequence