You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
'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',
version: '1.0.0',
params: {
apiKey: {
type: 'string',
required: true,
visibility: 'user-only',
description: 'Buffer API key',
},
channelId: {
type: 'string',
required: true,
visibility: 'user-or-llm',
description: 'Channel to create the post for (find it with the Get Channels operation)',
},
text: {
type: 'string',
required: false,
visibility: 'user-or-llm',
description: 'Text content of the post (required unless media is attached)',
},
mode: {
type: 'string',
required: true,
visibility: 'user-or-llm',
description:
'How to share the post: addToQueue, shareNext, shareNow, or customScheduled (requires dueAt)',
},
schedulingType: {
type: 'string',
required: false,
visibility: 'user-or-llm',
description:
'How the post publishes: automatic (Buffer publishes it, default) or notification (you get a mobile reminder)',
},
dueAt: {
type: 'string',
required: false,
visibility: 'user-or-llm',
description:
'Publish time as an ISO 8601 timestamp (required when mode is customScheduled)',
},
saveToDraft: {
type: 'boolean',
required: false,
visibility: 'user-or-llm',
description: 'Save the post as a draft instead of scheduling it',
},
media: {
type: 'file',
required: false,
visibility: 'user-or-llm',
description:
'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: {
type: 'string',
required: false,
visibility: 'user-or-llm',
description:
'Force the attachment type when it cannot be detected from the file or URL: image or video (default auto)',
},
mediaAltText: {
type: 'string',
required: false,
visibility: 'user-or-llm',
description: 'Alt text for an attached image',
},
assets: {
type: 'json',
required: false,
visibility: 'user-or-llm',
description: bufferInputDescription(
'AssetInput',
'Array of image, video, or document assets. Choose exactly one variant per asset. Omit when using media.'
),
},
metadata: {
type: 'json',
required: false,
visibility: 'user-or-llm',
description: bufferInputDescription(
'PostInputMetaData',
'Network-specific settings, including threads, link attachments, and publishing options.'
),
},
aiAssisted: {
type: 'boolean',
required: false,
visibility: 'user-or-llm',
description: 'Whether AI assisted with creating the post',
},
draftId: {
type: 'string',
required: false,
visibility: 'user-or-llm',
description: 'Draft identifier associated with the post',
},
ideaId: {
type: 'string',
required: false,
visibility: 'user-or-llm',
description: 'Source idea identifier',
},
source: {
type: 'string',
required: false,
visibility: 'user-or-llm',
description: 'Source application identifier',
},
tagIds: {
type: 'json',
required: false,
visibility: 'user-or-llm',
description: 'Array of tag IDs; on edit, [] clears tags and omission preserves them',
},
needsApproval: {
type: 'boolean',
required: false,
visibility: 'user-or-llm',
description: 'Request approval on creation (default false)',