Skip to main content
Buffer logo
  • Category: social media accounts
  • Auth: OAUTH2
  • Composio-managed OAuth available? No
  • Tools: 11
  • Triggers: 0
  • Slug: BUFFER
  • Version: 20261101_00

Tools

Slug: BUFFER_CREATE_IDEACreate 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

string
Optional call-to-action associated with the idea.
string
Optional idea body text. Provide a non-empty title, text, or both.
string
Optional idea title. Provide a non-empty title, text, or both.
string
Optional writable idea group ID from LIST_IDEA_GROUPS.
array
Optional intended social networks. Values must be exact Buffer Service enum names discovered through live GraphQL introspection.
boolean
Whether AI assisted in creating the idea content.
string
Optional date and time associated with the idea content.
string
required
Buffer organization ID in which to create the idea.
string
Optional idea ID after which to place the new idea. Requires group_id, and the referenced idea should belong to that group.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUFFER_CREATE_POST_DRAFTCreate 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

string
required
Draft text. This creates an internal Buffer draft only and never queues, schedules, or publishes it.
string
Optional source idea ID to associate with the post.
array
Optional Buffer tag IDs to associate with the post.
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.
boolean
Whether AI assisted in creating this content.
boolean
Set true only when the target channel’s posting policy requires approval.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUFFER_DELETE_POSTPermanently delete a Buffer post by ID, including a draft created for cleanup. This operation cannot be undone.

Input Parameters

string
required
ID of the Buffer post to permanently delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUFFER_DELETE_POST_TEMPLATEDelete 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

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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUFFER_GET_ACCOUNT_CONTEXTReturn 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

string
Optional organization ID to return channels for; omit to return channels for every organization on the account.
boolean
Whether locked channels should be included in channel results.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUFFER_LIST_IDEA_GROUPSList the idea workflow groups in a Buffer organization so an agent can discover group IDs for filtering or idea creation.

Input Parameters

string
required
Buffer organization ID from GET_ACCOUNT_CONTEXT.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUFFER_LIST_IDEASList content ideas in a Buffer organization, optionally filtering by explicit idea groups or grouped versus ungrouped workflow membership.

Input Parameters

string
Opaque next_cursor from a prior call; pass it back unchanged.
array
Only return ideas in these group IDs. Mutually exclusive with group_membership.
integer
Maximum ideas to return on this page.
string
required
Buffer organization ID from GET_ACCOUNT_CONTEXT.
string ("grouped" | "ungrouped")
Only return grouped or ungrouped ideas. Mutually exclusive with group_ids; omit both filters to include all groups.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUFFER_LIST_POSTSList and filter posts in a Buffer organization without requesting OAuth-inaccessible analytics fields.

Input Parameters

string
Opaque next_cursor from a prior call; pass it back unchanged.
array
Only return posts associated with these Buffer tag IDs.
array
Only return posts with these Buffer post statuses.
integer
Maximum posts to return in this page, capped at Buffer’s recommended 50.
string
Inclusive upper bound for scheduled due time as an ISO 8601 timestamp.
string ("dueAt" | "createdAt")
Optional Buffer post field used to order results: dueAt or createdAt.
array
Only return posts for these channel IDs.
string
Inclusive lower bound for scheduled due time as an ISO 8601 timestamp.
string ("asc" | "desc")
Sort direction when sort_field is supplied.
string
required
Buffer organization ID from GET_ACCOUNT_CONTEXT.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUFFER_LIST_POST_TEMPLATESList Buffer public templates and templates visible to the connected user in an organization, optionally filtered by visibility.

Input Parameters

string
Opaque next_cursor from a prior call. Pass it back unchanged to fetch the next page.
integer
Maximum templates to return on this page. Buffer recommends page sizes from 20 to 50.
string ("public" | "internal" | "private")
Optional visibility filter. It narrows results but cannot widen the connected user’s access.
string
required
Buffer organization ID used to resolve templates visible to the connected user.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUFFER_PUBLISH_POSTSQueue, 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

string
required
Post text to queue, schedule, or publish on every target channel.
string
Scheduled publication time. Required only for delivery_mode=‘custom_scheduled’ and rejected for other modes.
string
Optional source idea ID to associate with every created post.
array
Optional Buffer tag IDs to associate with every created post.
boolean
Whether AI assisted in creating this content.
array
required
One to 10 unique target channel IDs from GET_ACCOUNT_CONTEXT. Buffer receives one createPost mutation per channel; duplicate IDs are rejected.
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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: BUFFER_SAVE_POST_TEMPLATECreate a private or internal Buffer post template, or update an existing writable template when template_id is supplied.

Input Parameters

string
Reusable post body; required for creation and optional for update.
string
Emoji associated with the template; required for creation by Buffer’s live resolver and optional for update.
string
Template title; required for creation and optional for update.
string ("private" | "internal")
Template visibility. Public visibility is unavailable for non-official Buffer clients.
string
Template description; required for creation by Buffer’s live resolver and optional for update.
string
Existing writable template ID to update; omit to create a template.
string
Organization in which to create the template; required for creation and omitted for update.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not