Skip to content

Marketing skills for Claude Code and AI agents. CRO, copywriting, SEO, analytics, and growth engineering.

3.6 KB
Raw Blame

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 [email protected]

Relevant Skills

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