> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Buffer

> Buffer is a social media management platform for planning, creating, scheduling, and publishing content across connected channels.

![Buffer logo](https://mintcdn.com/composio-preview/PudKL42NVsy5O-ND/images/toolkits/buffer.svg?fit=max\&auto=format\&n=PudKL42NVsy5O-ND\&q=85\&s=56e242227ff3f11a8f82031c0ecee95d)

* **Category:** social media accounts
* **Auth:** OAUTH2
* **Composio-managed OAuth available?** No
* **Tools:** 11
* **Triggers:** 0
* **Slug:** `BUFFER`
* **Version:** 20261101\_00

## Tools

> [accordion] Create Idea
>
> **Slug:** `BUFFER_CREATE_IDEA`
>
> Create a persistent content idea in a Buffer organization. Buffer's public API provides no operation to update or delete an idea after creation, so this action cannot be undone through the API.
>
> #### Input Parameters
>
> **cta** `string`
>
> Optional call-to-action associated with the idea.
>
> **text** `string`
>
> Optional idea body text. Provide a non-empty title, text, or both.
>
> **title** `string`
>
> Optional idea title. Provide a non-empty title, text, or both.
>
> **group\_id** `string`
>
> Optional writable idea group ID from LIST\_IDEA\_GROUPS.
>
> **services** `array`
>
> Optional intended social networks. Values must be exact Buffer Service enum names discovered through live GraphQL introspection.
>
> **ai\_assisted** `boolean`
>
> Whether AI assisted in creating the idea content.
>
> **content\_date** `string`
>
> Optional date and time associated with the idea content.
>
> **organization\_id** `string` *required*
>
> Buffer organization ID in which to create the idea.
>
> **place\_after\_idea\_id** `string`
>
> Optional idea ID after which to place the new idea. Requires group\_id, and the referenced idea should belong to that group.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Post Draft
>
> **Slug:** `BUFFER_CREATE_POST_DRAFT`
>
> Create an internal text-post draft for exactly one Buffer channel. This action always saves a draft and does not queue, schedule, or publish it.
>
> #### Input Parameters
>
> **text** `string` *required*
>
> Draft text. This creates an internal Buffer draft only and never queues, schedules, or publishes it.
>
> **idea\_id** `string`
>
> Optional source idea ID to associate with the post.
>
> **tag\_ids** `array`
>
> Optional Buffer tag IDs to associate with the post.
>
> **channel\_id** `string` *required*
>
> Exactly one target social channel ID from GET\_ACCOUNT\_CONTEXT. The post is saved as an internal draft for this channel and is not published.
>
> **ai\_assisted** `boolean`
>
> Whether AI assisted in creating this content.
>
> **needs\_approval** `boolean`
>
> Set true only when the target channel's posting policy requires approval.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Post
>
> **Slug:** `BUFFER_DELETE_POST`
>
> Permanently delete a Buffer post by ID, including a draft created for cleanup. This operation cannot be undone.
>
> #### Input Parameters
>
> **post\_id** `string` *required*
>
> ID of the Buffer post to permanently delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Post Template
>
> **Slug:** `BUFFER_DELETE_POST_TEMPLATE`
>
> Delete a writable private Buffer template, or an internal template when the connected user is an organization admin or owner. This operation cannot be undone.
>
> #### Input Parameters
>
> **template\_id** `string` *required*
>
> ID of a template the connected user owns or may administer. Do not pass an arbitrary public template ID from LIST\_POST\_TEMPLATES.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Account Context
>
> **Slug:** `BUFFER_GET_ACCOUNT_CONTEXT`
>
> Return the connected Buffer account, its organizations, and the accessible social channels in each organization so an agent can discover the IDs required by other tools.
>
> #### Input Parameters
>
> **organization\_id** `string`
>
> Optional organization ID to return channels for; omit to return channels for every organization on the account.
>
> **include\_locked\_channels** `boolean`
>
> Whether locked channels should be included in channel results.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Idea Groups
>
> **Slug:** `BUFFER_LIST_IDEA_GROUPS`
>
> List the idea workflow groups in a Buffer organization so an agent can discover group IDs for filtering or idea creation.
>
> #### Input Parameters
>
> **organization\_id** `string` *required*
>
> Buffer organization ID from GET\_ACCOUNT\_CONTEXT.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Ideas
>
> **Slug:** `BUFFER_LIST_IDEAS`
>
> List content ideas in a Buffer organization, optionally filtering by explicit idea groups or grouped versus ungrouped workflow membership.
>
> #### Input Parameters
>
> **cursor** `string`
>
> Opaque next\_cursor from a prior call; pass it back unchanged.
>
> **group\_ids** `array`
>
> Only return ideas in these group IDs. Mutually exclusive with group\_membership.
>
> **page\_size** `integer`
>
> Maximum ideas to return on this page.
>
> **organization\_id** `string` *required*
>
> Buffer organization ID from GET\_ACCOUNT\_CONTEXT.
>
> **group\_membership** `string ("grouped" | "ungrouped")`
>
> Only return grouped or ungrouped ideas. Mutually exclusive with group\_ids; omit both filters to include all groups.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Posts
>
> **Slug:** `BUFFER_LIST_POSTS`
>
> List and filter posts in a Buffer organization without requesting OAuth-inaccessible analytics fields.
>
> #### Input Parameters
>
> **cursor** `string`
>
> Opaque next\_cursor from a prior call; pass it back unchanged.
>
> **tag\_ids** `array`
>
> Only return posts associated with these Buffer tag IDs.
>
> **statuses** `array`
>
> Only return posts with these Buffer post statuses.
>
> **page\_size** `integer`
>
> Maximum posts to return in this page, capped at Buffer's recommended 50.
>
> **due\_at\_end** `string`
>
> Inclusive upper bound for scheduled due time as an ISO 8601 timestamp.
>
> **sort\_field** `string ("dueAt" | "createdAt")`
>
> Optional Buffer post field used to order results: dueAt or createdAt.
>
> **channel\_ids** `array`
>
> Only return posts for these channel IDs.
>
> **due\_at\_start** `string`
>
> Inclusive lower bound for scheduled due time as an ISO 8601 timestamp.
>
> **sort\_direction** `string ("asc" | "desc")`
>
> Sort direction when sort\_field is supplied.
>
> **organization\_id** `string` *required*
>
> Buffer organization ID from GET\_ACCOUNT\_CONTEXT.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Post Templates
>
> **Slug:** `BUFFER_LIST_POST_TEMPLATES`
>
> List Buffer public templates and templates visible to the connected user in an organization, optionally filtered by visibility.
>
> #### Input Parameters
>
> **cursor** `string`
>
> Opaque next\_cursor from a prior call. Pass it back unchanged to fetch the next page.
>
> **page\_size** `integer`
>
> Maximum templates to return on this page. Buffer recommends page sizes from 20 to 50.
>
> **visibility** `string ("public" | "internal" | "private")`
>
> Optional visibility filter. It narrows results but cannot widen the connected user's access.
>
> **organization\_id** `string` *required*
>
> Buffer organization ID used to resolve templates visible to the connected user.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Publish Posts
>
> **Slug:** `BUFFER_PUBLISH_POSTS`
>
> Queue, schedule, or immediately publish the same text post to one to 10 Buffer channels. Calls are non-atomic: successes are not rolled back, and a global provider failure can leave later channels unattempted; results classify successes, failures, and unattempted channels.
>
> #### Input Parameters
>
> **text** `string` *required*
>
> Post text to queue, schedule, or publish on every target channel.
>
> **due\_at** `string`
>
> Scheduled publication time. Required only for delivery\_mode='custom\_scheduled' and rejected for other modes.
>
> **idea\_id** `string`
>
> Optional source idea ID to associate with every created post.
>
> **tag\_ids** `array`
>
> Optional Buffer tag IDs to associate with every created post.
>
> **ai\_assisted** `boolean`
>
> Whether AI assisted in creating this content.
>
> **channel\_ids** `array` *required*
>
> One to 10 unique target channel IDs from GET\_ACCOUNT\_CONTEXT. Buffer receives one createPost mutation per channel; duplicate IDs are rejected.
>
> **delivery\_mode** `string ("add_to_queue" | "custom_scheduled" | "share_now")` *required*
>
> Publication timing: add\_to\_queue adds to each channel queue, custom\_scheduled uses due\_at, and share\_now publishes externally now.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Save Post Template
>
> **Slug:** `BUFFER_SAVE_POST_TEMPLATE`
>
> Create a private or internal Buffer post template, or update an existing writable template when template\_id is supplied.
>
> #### Input Parameters
>
> **body** `string`
>
> Reusable post body; required for creation and optional for update.
>
> **emoji** `string`
>
> Emoji associated with the template; required for creation by Buffer's live resolver and optional for update.
>
> **title** `string`
>
> Template title; required for creation and optional for update.
>
> **visibility** `string ("private" | "internal")`
>
> Template visibility. Public visibility is unavailable for non-official Buffer clients.
>
> **description** `string`
>
> Template description; required for creation by Buffer's live resolver and optional for update.
>
> **template\_id** `string`
>
> Existing writable template ID to update; omit to create a template.
>
> **organization\_id** `string`
>
> Organization in which to create the template; required for creation and omitted for update.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
