Buffer Uploader icon

Buffer Uploader

Upload content to Buffer

Buffer Uploader

AI-generated

Summary

Upload a post with text and optional media assets to a selected Buffer organization's social media channel, specifying scheduling and sharing options.

Inputs

  • organizationId (required) — Select or specify the Buffer organization to post from.
  • service (required) — Choose the social media service (e.g., Facebook, Instagram, Twitter) where the post will be published.
  • channelId (required) — Select or specify the channel (account/profile) within the organization and service to post to.
  • text (required) — The text content of the post to upload.
  • schedulingType — Choose the scheduling type for the post, either 'Automatic' or 'Notification'.
  • mode — Determine how the post is scheduled, e.g., added to queue, shared now, or custom scheduled.
  • saveToDraft — Optionally save the post as a draft instead of scheduling it.
  • assetInputMode — Choose how to provide media assets: via UI inputs or JSON array.
  • assetsUi — When using UI mode, add multiple assets (images, videos, links, or documents) by URL, including optional video thumbnails.
  • assetsJson — When using JSON mode, provide an array of asset objects with URLs for images, videos, links, or documents.
  • additionalFields.metadataJson — Provide service-specific metadata as JSON to customize the post, e.g., post type for Facebook or Instagram.
  • facebookPostType — Specify Facebook post type: post, story, or reel (shown if service is Facebook).
  • instagramPostType — Specify Instagram post type: post, story, or reel (shown if service is Instagram).
  • instagramShouldShareToFeed — Boolean to determine if the Instagram post should be shared to feed (shown if service is Instagram).
  • googleBusinessPostType — Specify Google Business post type: event, offer, or what's new (shown if service is Google Business).

Output shape

a single JSON object per input item containing the API response with post details under 'bufferResponse'.

Includes post id, text, and media assets metadata if successful. Throws errors on API failure or invalid JSON inputs.

Links

Discussion