Social · CONNECTIONCreate, schedule and manage Buffer posts, ideas, content items, tags and templates across your social channels.
Explore 44 workflow actions for Buffer, including account permissions and operation limits.
Choose an action in the workflow builder, connect an account, and map its inputs. These actions are available in the catalog; your account access and a successful test determine whether they work for your setup.
Add a post that already exists to a content item. The mutation creates no post. To add a new post, call createPost first. (Buffer marks this experimental.)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create a content item together with all of its channel-specific post variants in a single operation. Validation is all-or-nothing: if any variant fails validation, no content item and no variants are created. Variants that fail while being processed after creation are reported per channel in the failure payload; the content item and its variants are still created in that case. This API is an... (Buffer marks this experimental.)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create a content item holding a channel-less draft, before any channels are selected. No network-specific validation applies to the draft content. The draft needs text or at least one asset. This API is an early preview and can change without a deprecation period. (Buffer marks this experimental.)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create post for channel
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create a post template visible only to the caller (private) or to the caller's organization (internal). (Buffer marks this a preview.)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Creates a snippet in an organization. (Buffer marks this experimental.)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create a tag for an organization. The name must be unique within the organization; a duplicate is refused with DuplicateError. Creation is refused with LimitReachedError once the organization already holds as many tags as its plan allows. This API is an early preview and can change without a deprecation period. (Buffer marks this experimental.)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Create a new idea with the given content and metadata
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete a content item: the item itself and any posts created from it. Deletion is all-or-nothing. Every post must be deletable on its own, or nothing is deleted and every blocked post is reported at once. A post can only be deleted while it is a draft, awaiting approval, scheduled, or failed, so an item cannot be deleted while any of its posts is publishing or already published. An item still... (Buffer marks this experimental.)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete a post by id.
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete a post template owned by the caller (or an internal template in the caller's organization, if the caller is an org admin/owner). (Buffer marks this a preview.)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Deletes a snippet. (Buffer marks this experimental.)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Delete a tag. The tag is removed from every post, idea and content item carrying it; those items are otherwise untouched. A locked tag can be deleted, and deleting an unlocked tag frees a slot for the oldest locked one. See Tag.isLocked. This API is an early preview and can change without a deprecation period. (Buffer marks this experimental.)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Edit post for channel
A repeated request may repeat the external action. Review the previous result before retrying a write.
Fetches a single channel using the provided ID
Fetch a single content item by id. Errors if no content item with that id exists. This API is an early preview and can change without a deprecation period. (Buffer marks this experimental.)
Fetches a post by PostID for the given organization: first and last can be set for forward pagination using Relay convention
Fetch a single post template by ID. Returns null if not found. (Buffer marks this a preview.)
Fetch a single tag by id. Resolves to null with a NOT_FOUND error when no tag has that id, and with an UNAUTHORIZED error when the tag belongs to an organization the caller cannot read. Both are reported in the errors array. This API is an early preview and can change without a deprecation period. (Buffer marks this experimental.)
Aggregate normalized post metrics across a filtered post set. Useful for yearly summaries, channel-level rollups, and BI exports without paginating through thousands of posts. For per-post metrics, use posts(input) or post(input) with a metrics { … } selection, this query is purely for aggregation. The result always contains a baseline trio of entries: postCount (number of matched posts in the...
Returns daily posting limit status for the given channels on the specified date.
Retrieves the authenticated user's account information
Global, per-organization configuration: the connected channels the actor can view (with per-feature authorization) plus the service-level capability catalog (services). One round trip for every capability domain; clients select only what they need. (Buffer marks this experimental.)
Return trending music and original sounds in a single request. Requires Facebook Login. Instagram Login channels return ChannelRefreshRequired. (Buffer marks this experimental.)
Return Meta trending Instagram audio for one channel. Requires Facebook Login. Instagram Login channels return ChannelRefreshRequired. (Buffer marks this experimental.)
Fetch all channels for the organization taking into account the current's user permissions
Fetch an organization's content items in the requested order, newest first by default. Uses standard cursor pagination: pass the previous page's pageInfo.endCursor as after to fetch the next page. Requesting more than 100 items in a single page is rejected. This API is an early preview and can change without a deprecation period. (Buffer marks this experimental.)
Retrieves idea groups based on the provided input parameters.
Fetch a paginated list of ideas with optional filtering
Fetch the templates visible to the current actor for the template library: public templates, plus internal templates from the supplied organizationId, plus private templates owned by the actor's account. The visibility scope is always pinned to the actor and the supplied organization, the input filter can only narrow within that scope, never widen it. (Buffer marks this a preview.)
Fetches posts for the given organization: first and last can be set for forward pagination using Relay convention
Returns the snippets of an organization, sorted by name. Uses standard cursor pagination: pass the previous page's pageInfo.endCursor as after to fetch the next page. Requesting more than 100 snippets in a single page is rejected. A cursor whose snippet was deleted reports a BAD_USER_INPUT error. Fetch again from the first page. (Buffer marks this experimental.)
Fetch a page of the organization's tags, sorted by name in ascending order. Uses standard cursor pagination: pass the previous page's pageInfo.endCursor as after to fetch the next page. Requesting more than 100 tags in a single page is rejected. This API is an early preview and can change without a deprecation period. (Buffer marks this experimental.)
Move a queued post to the top or bottom of its channel's queue. Unlike editPost, this is a scheduling-only operation that never re-validates the post's content. (Buffer marks this experimental.)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Refresh metadata and preview availability for one Instagram audio asset. Requires Facebook Login. Instagram Login channels return ChannelRefreshRequired. (Buffer marks this experimental.)
Remove a post from a content item. The post survives on its own channel and keeps its schedule, text, status, and tags. Only the link to the content item goes away. To delete a post, call deletePost. A second call with a post that belongs to no content item changes nothing, and the mutation reports success. (Buffer marks this experimental.)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Search Instagram audio for one channel. Requires Facebook Login. Instagram Login channels return ChannelRefreshRequired. (Buffer marks this experimental.)
Search music and original sounds in a single request. Requires Facebook Login. Instagram Login channels return ChannelRefreshRequired. (Buffer marks this experimental.)
Promote a channel-less draft into channel-specific posts. One-way: once promoted, the content item can no longer be edited as a draft. If any post fails validation, none are created. A failure can also be reported when a post could not be fully processed after the promotion already took effect; re-fetch the content item to check its state before retrying. This API is an early preview and can... (Buffer marks this experimental.)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update a content item's title or target date. Fields that are omitted keep their current value. This API is an early preview and can change without a deprecation period. (Buffer marks this experimental.)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Replace a channel-less draft's content in full, and optionally set the content item's target date in the same write. The draft needs text or at least one asset. Only valid while the content item is still a draft. This API is an early preview and can change without a deprecation period. (Buffer marks this experimental.)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update a post template owned by the caller (or an internal template in the caller's organization, if the caller is an org admin/owner). (Buffer marks this a preview.)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Replaces the name and text of a snippet. (Buffer marks this experimental.)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Update a tag's name and color. Both values are replaced, so send the current value for the one you are not changing. The new name must still be unique within the organization; a duplicate is refused with DuplicateError. A locked tag cannot be edited and the update is refused. See Tag.isLocked. This API is an early preview and can change without a deprecation period. (Buffer marks this experimental.)
A repeated request may repeat the external action. Review the previous result before retrying a write.
Use the account and permissions required for your process. Review the connection check before configuring a workflow action.
Select a listed operation and map its required inputs. Use test records and add a human approval before writes that need review.
Inspect step outputs and confirm the result in Buffer. A saved workflow is not a completed provider action.
