# Buffer

Manage Buffer: profiles, scheduled updates, and posting to social channels. Exposes **29 actions** covering the full API surface
the agent needs - read and write.

## What it can do

| Method | What it does |
| --- | --- |
| `buffer_get_user` | Get authenticated user info - GET /user. |
| `buffer_list_profiles` | List all connected social media profiles (accounts) - GET /profiles. |
| `buffer_get_profile` | Get a single profile (social media account) - GET /profiles/{id}. |
| `buffer_get_profile_schedules` | Get posting schedules for a profile - GET /profiles/{id}/schedules. |
| `buffer_update_profile_schedules` | Update posting schedules for a profile - POST /profiles/{id}/schedules/update. |
| `buffer_get_profile_timezones` | Get available timezones for a profile - GET /profiles/{id}/timezones. |
| `buffer_create_post` | Create a post on one or more profiles - POST /posts/create. |
| `buffer_get_post` | Get a single post by ID - GET /posts/{id}. |
| `buffer_update_post` | Update a post - POST /posts/{id}/update. |
| `buffer_delete_post` | Delete a post - DELETE /posts/{id}. |
| `buffer_share_post` | Publish/share a scheduled post immediately - POST /posts/{id}/share. |
| `buffer_requeue_post` | Requeue a post (schedule for later) - POST /posts/{id}/requeue. |
| `buffer_get_pending_posts` | List pending (scheduled) posts for a profile - GET /posts/pending/{profile_id}. |
| `buffer_get_sent_posts` | List sent/published posts for a profile - GET /posts/sent/{profile_id}. |
| `buffer_create_update` | Create a new update/post (recommended newer API) - POST /updates/create. |
| `buffer_get_update` | Get a single update by ID - GET /updates/{id}. |
| `buffer_update_update` | Update an update/post - PUT /updates/{id}. |
| `buffer_delete_update` | Delete an update - DELETE /updates/{id}. |
| `buffer_get_pending_updates` | List pending updates - GET /updates/pending. |
| `buffer_get_sent_updates` | List sent updates - GET /updates/sent. |
| `buffer_get_profile_analytics_overview` | Get profile overview analytics (followers, engagement, etc.) - GET /profiles/{id}/analytics/overview. |
| `buffer_get_profile_analytics_posts` | Get per-post analytics (engagement, impressions, clicks) - GET /profiles/{id}/analytics/posts. |
| `buffer_get_profile_analytics_interactions` | Get audience interactions analytics - GET /profiles/{id}/analytics/interactions. |
| `buffer_create_link_share` | Create a shortened link and get share data - POST /links/shares. |
| `buffer_list_team_members` | List team members - GET /team/members. |
| `buffer_list_team_invitations` | List pending team invitations - GET /team/invitations. |
| `buffer_create_team_invitation` | Send a team invitation - POST /team/invitations. |
| `buffer_delete_team_invitation` | Cancel/delete a team invitation - DELETE /team/invitations/{id}. |
| `buffer_remove_team_member` | Remove a team member - DELETE /team/members/{user_id}. |

## How to get credentials

This connector uses **OAuth 2.0**. In FlyMyAI, open the tool and click
**Connect** - you'll be redirected to Buffer to authorize, then back to
FlyMyAI. There is no API key to paste.

> The OAuth app must be registered by FlyMyAI for this provider. If you see
> *"connection not configured"*, the provider's client credentials are still
> being set up - check back shortly.

## Fields to fill in FlyMyAI

| FlyMyAI field | Where it comes from |
| --- | --- |
| _(none)_ | Connect via OAuth - nothing to paste. |

## Troubleshooting

- **`401 Unauthorized` / `403 Forbidden`** - the OAuth connection expired or was revoked - reconnect.
- **`429 Too Many Requests`** - you hit the provider rate limit; retry after a short backoff.
- **Unexpected `4xx` on writes** - double-check required fields; the agent confirms before write actions.

## Links

- [Buffer API documentation](https://buffer.com/developers/api)