Buffer

Usage Instructions

Integrate Buffer into your workflow. Create, schedule, edit, and delete posts across connected social channels (Instagram, LinkedIn, X, Facebook, TikTok, and more), attach images or videos, browse channels, and capture content ideas using the Buffer API.

Tools

`buffer_create_post`

Create a post in Buffer for a channel — add it to the queue, share it immediately, schedule it for a specific time, or save it as a draft, optionally with an image or video attachment

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Buffer API key
`channelId`	string	Yes	Channel to create the post for (find it with the Get Channels operation)
`text`	string	No	Text content of the post (required unless media is attached)
`mode`	string	Yes	How to share the post: addToQueue, shareNext, shareNow, or customScheduled (requires dueAt)
`schedulingType`	string	No	How the post publishes: automatic (Buffer publishes it, default) or notification (you get a mobile reminder)
`dueAt`	string	No	Publish time as an ISO 8601 timestamp (required when mode is customScheduled)
`saveToDraft`	boolean	No	Save the post as a draft instead of scheduling it
`media`	file	No	Image or video to attach — an uploaded file, a file reference from a previous block, or a publicly accessible URL. Buffer downloads the media at publish time; uploaded files are shared via a link valid for 7 days, so use a public URL for posts scheduled further out
`mediaType`	string	No	Force the attachment type when it cannot be detected from the file or URL: image or video (default auto)
`mediaAltText`	string	No	Alt text for an attached image

Output

Parameter	Type	Description
`post`	object	The created post

`buffer_edit_post`

Edit an existing Buffer post — update its text, schedule, or media. Attaching new media replaces the existing attachments

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Buffer API key
`postId`	string	Yes	ID of the post to edit
`text`	string	No	New text content of the post
`mode`	string	Yes	How to share the post: addToQueue, shareNext, shareNow, or customScheduled (requires dueAt)
`schedulingType`	string	No	How the post publishes: automatic (Buffer publishes it, default) or notification (you get a mobile reminder)
`dueAt`	string	No	Publish time as an ISO 8601 timestamp (required when mode is customScheduled)
`saveToDraft`	boolean	No	Save the post as a draft instead of scheduling it
`media`	file	No	Image or video to attach — an uploaded file, a file reference from a previous block, or a publicly accessible URL. Buffer downloads the media at publish time; uploaded files are shared via a link valid for 7 days, so use a public URL for posts scheduled further out. Replaces existing attachments
`mediaType`	string	No	Force the attachment type when it cannot be detected from the file or URL: image or video (default auto)
`mediaAltText`	string	No	Alt text for an attached image

Output

Parameter	Type	Description
`post`	object	The updated post

`buffer_get_posts`

List posts in a Buffer organization, optionally filtered by channel and status (draft, needs_approval, scheduled, sending, sent, error)

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Buffer API key
`organizationId`	string	Yes	Buffer organization ID (find it with the Get Account operation)
`channelIds`	string	No	Comma-separated channel IDs to filter by
`status`	string	No	Comma-separated statuses to filter by: draft, needs_approval, scheduled, sending, sent, error
`limit`	number	No	Maximum number of posts to return (default 20)
`after`	string	No	Pagination cursor from a previous page (pageInfo.endCursor)
`sortBy`	string	No	Field to sort by: dueAt or createdAt (default dueAt)
`sortDirection`	string	No	Sort direction: asc or desc (default asc)

Output

Parameter	Type	Description
`posts`	array	Posts matching the filters
`pageInfo`	object	Pagination info for fetching the next page

`buffer_get_post`

Get a single Buffer post by ID, including its status, schedule, and media

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Buffer API key
`postId`	string	Yes	ID of the post to fetch

Output

Parameter	Type	Description
`post`	object	The requested post

`buffer_delete_post`

Delete a Buffer post by ID

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Buffer API key
`postId`	string	Yes	ID of the post to delete

Output

Parameter	Type	Description
`deleted`	boolean	Whether the post was deleted
`id`	string	ID of the deleted post

`buffer_get_channels`

List the social media channels connected to a Buffer organization, including their channel IDs (needed to create posts)

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Buffer API key
`organizationId`	string	Yes	Buffer organization ID (find it with the Get Account operation)

Output

Parameter	Type	Description
`channels`	array	Channels connected to the organization

`buffer_create_idea`

Save a content idea to a Buffer organization for later drafting and scheduling

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Buffer API key
`organizationId`	string	Yes	Buffer organization ID (find it with the Get Account operation)
`text`	string	Yes	Text content of the idea
`title`	string	No	Optional title for the idea
`groupId`	string	No	Optional idea group (board column) to place the idea in

Output

Parameter	Type	Description
`idea`	object	The created idea

`buffer_get_ideas`

List content ideas saved in a Buffer organization

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Buffer API key
`organizationId`	string	Yes	Buffer organization ID (find it with the Get Account operation)
`limit`	number	No	Maximum number of ideas to return (default 20)
`after`	string	No	Pagination cursor from a previous page (pageInfo.endCursor)

Output

Parameter	Type	Description
`ideas`	array	Content ideas in the organization
`pageInfo`	object	Pagination info for fetching the next page

`buffer_get_idea_groups`

List idea groups (board columns) in a Buffer organization, including the group IDs used when creating ideas

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Buffer API key
`organizationId`	string	Yes	Buffer organization ID (find it with the Get Account operation)

Output

Parameter	Type	Description
`ideaGroups`	array	Idea groups (board columns) in the organization

`buffer_get_account`

Get the authenticated Buffer account, including its organizations and their IDs (needed for channel and post operations)

Input

Parameter	Type	Required	Description
`apiKey`	string	Yes	Buffer API key

Output

Parameter	Type	Description
`account`	object	The authenticated Buffer account

Notes

Category: tools
Type: buffer

Buffer

On this page