Platform parameters

When you create or update a post, data is keyed by platform — data.TWITTER, data.TIKTOK, etc. Each platform accepts its own set of fields. This page is the field reference for all of them. (For connecting accounts and platform quirks, see the per-platform pages under Platforms in the sidebar.)

uploadIds are ids returned by upload-content.
thumbnail (where present) is a public URL of an image already uploaded to bundle.social — use it as a video cover when an offset isn’t enough.
Bold = required for that platform.

The CLI builds data for you: --content → text, -m → uploadIds, --platform-settings '{"<P>":{...}}' → merged into data.<P>. The same fields apply to the SDK and the MCP server. Snippets below that say integrations:trigger … are the CLI form of the same trigger_integration_tool MCP tool / misc.* SDK helper.

X / Twitter — `data.TWITTER`

Field	Type	Notes
`text`	string	Post text. ~280 chars (longer if the connected account is X Premium).
`uploadIds`	string[]	Up to 4 images or 1 video/GIF.
`replySettings`	`EVERYONE` \| `FOLLOWING` \| `MENTIONED_USERS` \| `SUBSCRIBERS` \| `VERIFIED`	Who can reply.

Threads: post the first tweet, then add the rest as replies with comments:create --post-id <id> -c "..." -c "..." (X threads go through the comments API, not data). No analytics surface for X.

{ "TWITTER": { "text": "Shipping day 🚀", "replySettings": "EVERYONE" } }

Bluesky — `data.BLUESKY`

Field	Type	Notes
`text`	string	~300 chars.
`uploadIds`	string[]	Up to 4 images, or 1 video (set `videoAlt`).
`tags`	string[]	Extra hashtags (without `#`), up to 8.
`labels`	(`!no-unauthenticated` \| `porn` \| `sexual` \| `nudity` \| `graphic-media`)[]	Self-labels / content warnings.
`quoteUri`	string	AT-URI of a post to quote (`at://…/app.bsky.feed.post/<rkey>`).
`externalUrl` / `externalTitle` / `externalDescription`	string	External link card.
`videoAlt`	string	Alt text for a video embed.

{ "BLUESKY": { "text": "New post", "tags": ["launch", "indie"], "externalUrl": "https://bundle.social" } }

Mastodon — `data.MASTODON`

Field	Type	Notes
`text`	string	Length depends on the connected instance (commonly ~500).
`uploadIds`	string[]	Up to 4 images or 1 video.
`privacy`	`PUBLIC` \| `UNLISTED` \| `PRIVATE` \| `DIRECT`	Visibility.
`spoiler`	string	Content-warning text (collapses the post behind it).
`thumbnail`	string (URL)	Cover image for a video.

{ "MASTODON": { "text": "Hello fediverse", "privacy": "PUBLIC", "spoiler": "long read" } }

Threads — `data.THREADS`

Field	Type	Notes
`text`	string	~500 chars.
`uploadIds`	string[]	Up to ~10 images, or 1 video.
`mediaItems`	`{ uploadId, altText? }[]`	Per-image alt text (alternative to `uploadIds`).

{ "THREADS": { "text": "Quick thought", "mediaItems": [{ "uploadId": "<id>", "altText": "chart" }] } }

LinkedIn — `data.LINKEDIN`

Field	Type	Notes
`text`	string	Required. ~3000 chars. Works for a personal profile or a company page depending on which account the user connected.
`uploadIds`	string[]	Images, a single video, or a document/PDF.
`link`	string (URL)	For an article-preview post.
`mediaTitle`	string	Title for a video or document post (LinkedIn otherwise shows the post date under videos).
`privacy`	`CONNECTIONS` \| `PUBLIC` \| `LOGGED_IN` \| `CONTAINER`	Visibility.
`hideFromFeed`	boolean	Don’t show in the main feed.
`disableReshare`	boolean	Disallow resharing.

Mentions: discover URNs with integrations:trigger linkedin:mentions --data '{"q":"...","scope":"organizations"}' and put them in text.

{ "LINKEDIN": { "text": "We just shipped X.", "privacy": "PUBLIC", "mediaTitle": "Demo" } }

Facebook (Page) — `data.FACEBOOK`

Field	Type	Notes
`type`	`POST` \| `REEL` \| `STORY`	Default `POST`.
`text`	string	Caption / message.
`uploadIds`	string[]	Images, or a single video.
`mediaItems`	`{ uploadId, altText? }[]`	Per-image alt text.
`link`	string (URL)	Link attachment — `type: POST` only.
`mediaTitle`	string	Video title — `type: POST` with a video only (not REEL/STORY).
`thumbnail`	string (URL)	Video cover image.
`nativeScheduleTime`	string (ISO 8601, local)	Schedule directly in Meta’s scheduler instead of publishing now; max 30 days ahead.

{ "FACEBOOK": { "type": "POST", "text": "Look at this", "link": "https://bundle.social" } }

Instagram — `data.INSTAGRAM`

Field	Type	Notes
`type`	`POST` \| `REEL` \| `STORY`	`POST` = single image, carousel (`carouselItems`), or feed video; `REEL` = single video; `STORY` = image or short video.
`text`	string	Caption.
`uploadIds`	string[]	Single image/video for `POST`/`REEL`/`STORY`. Square ≥1080×1080 or portrait 4:5; Reels 9:16, up to 90s.
`altText`	string	Alt text for a single-image post.
`carouselItems`	`{ uploadId, altText?, tagged?: { username, x, y }[] }[]`	Carousel slides (for `type: POST`).
`thumbnailOffset`	number (ms)	Frame to use as the published video’s cover.
`thumbnail`	string (URL)	Cover image (alternative to offset).
`shareToFeed`	boolean	Reels only — also show in the Feed tab.
`collaborators`	string[]	Usernames to invite as collaborators.
`tagged`	`{ username, x?, y? }[]`	People tags for a single-image post.
`locationId`	string	A location id — discover with `integrations:trigger instagram:locations --data '{"q":"..."}'`.
`autoFitImage` / `autoCropImage`	boolean	Let bundle.social fit/crop the image to a valid aspect ratio.
`trialParams`	`{ graduationStrategy: "MANUAL" \| "SS_PERFORMANCE" }`	Reels only — trial reels are shown to non-followers first.

Account types are connected via Facebook or directly via Instagram (instagramConnectionMethod on the integration).

{ "INSTAGRAM": { "type": "REEL", "text": "BTS", "shareToFeed": true, "thumbnailOffset": 1500 } }

{ "INSTAGRAM": { "type": "POST", "text": "Carousel", "carouselItems": [
  { "uploadId": "<id1>", "altText": "slide 1" },
  { "uploadId": "<id2>", "altText": "slide 2" }
] } }

TikTok — `data.TIKTOK`

Field	Type	Notes
`type`	`VIDEO` \| `IMAGE`	`VIDEO` = 1 video; `IMAGE` = photo carousel.
`privacy`	`PUBLIC_TO_EVERYONE` \| `MUTUAL_FOLLOW_FRIENDS` \| `FOLLOWER_OF_CREATOR` \| `SELF_ONLY`	Effectively required by TikTok.
`text`	string	Caption.
`uploadIds`	string[]	The video, or the photos for `type: IMAGE`. Video: MP4/MOV/WEBM, ≥540p, portrait 9:16 recommended, up to ~10 min.
`photoCoverIndex`	number	Which photo is the cover (for `type: IMAGE`).
`thumbnailOffset`	number (ms)	Frame to use as the video cover.
`thumbnail`	string (URL)	Cover image (alternative to offset).
`isBrandContent` / `isOrganicBrandContent`	boolean	Disclosure: paid third-party partnership / promoting your own business.
`disableComments` / `disableDuet` / `disableStitch`	boolean	Interaction restrictions.
`isAiGenerated`	boolean	Mark the video as AI-generated.
`autoAddMusic`	boolean	Let TikTok add music to photos.
`autoScale`	boolean	Auto-scale the video.
`uploadToDraft`	boolean	Upload as a TikTok draft instead of publishing.
`musicSoundInfo`	`{ musicSoundId, musicSoundVolume?, musicSoundStart?, musicSoundEnd?, videoOriginalSoundVolume? }`	Commercial music — get a `song_clip_id` from `integrations:trigger tiktok:trending-music`. Volumes 0–100; start/end in ms.

{ "TIKTOK": { "type": "VIDEO", "text": "Launch BTS", "privacy": "PUBLIC_TO_EVERYONE", "disableStitch": true } }

YouTube — `data.YOUTUBE`

Field	Type	Notes
`type`	`VIDEO` \| `SHORT`	`SHORT` = vertical ≤60s; `VIDEO` = full upload.
`uploadIds`	string[]	One video.
`text`	string	The video title (the post `--title` flag also maps here).
`description`	string	Video description.
`thumbnail`	string (URL)	Custom thumbnail (`type: VIDEO`).
`privacy`	`PUBLIC` \| `UNLISTED` \| `PRIVATE`	Visibility.
`madeForKids`	boolean	Required-ish — YouTube needs you to declare this.
`containsSyntheticMedia`	boolean	Mark AI-generated content.
`hasPaidProductPlacement`	boolean	Declare paid placements.

(There’s no categoryId in the post data itself — fetch categories with integrations:trigger youtube:categories --data '{"regionCode":"US"}'; playlist management is via the SDK’s misc.youtube* methods / integrations:trigger youtube:playlists.)

{ "YOUTUBE": { "type": "SHORT", "text": "Launch BTS", "description": "Behind the scenes…", "privacy": "PUBLIC", "madeForKids": false } }

Reddit — `data.REDDIT`

Field	Type	Notes
`sr`	string	Subreddit (`r/subredditName`) or `u/username`.
`text`	string	The post title for link/text posts (Reddit’s “title”).
`description`	string	The body for a self post.
`uploadIds`	string[]	An image or video.
`link`	string (URL)	Link post target.
`nsfw`	boolean	Mark NSFW.
`flairId`	string	Required if the subreddit requires a flair — get options with `integrations:trigger reddit:flairs --data '{"subreddit":"r/<sub>"}'`.

Before posting, run integrations:trigger reddit:requirements --data '{"subreddit":"r/<sub>"}' to learn title length limits, allowed post types, and whether a flair is required.

{ "REDDIT": { "sr": "r/dataisbeautiful", "text": "Our 2026 growth, visualized", "uploadIds": ["<id>"], "flairId": "<flair-id>" } }

Discord — `data.DISCORD`

Field	Type	Notes
`channelId`	string	The connected server channel (an integration “channel” id — see `integrations:list`).
`text`	string	Message content. ≤2000 chars.
`uploadIds`	string[]	Attachments.
`username`	string	Override the author name shown (webhook).
`avatarUrl`	string (URL)	Override the author avatar (webhook).

{ "DISCORD": { "channelId": "<channel-id>", "text": "New release 🎉" } }

Slack — `data.SLACK`

Field	Type	Notes
`channelId`	string	The connected workspace channel (an integration “channel” id — see `integrations:list`).
`text`	string	Message text.
`uploadIds`	string[]	Attachments.
`username`	string	Override the author name shown.
`avatarUrl`	string (URL)	Override the author avatar.

{ "SLACK": { "channelId": "<channel-id>", "text": "Standup notes…" } }

Google Business Profile — `data.GOOGLE_BUSINESS`

Field	Type	Notes
`text`	string	The update body.
`uploadIds`	string[]	Images/videos.
`topicType`	`STANDARD` \| `EVENT` \| `OFFER` \| `ALERT`	Post kind.
`languageCode`	string	Language tag like `en` / `en-US`.
`callToActionType`	`BOOK` \| `ORDER` \| `SHOP` \| `LEARN_MORE` \| `SIGN_UP` \| `CALL`	CTA button.
`callToActionUrl`	string (URL)	CTA target.
`eventTitle` / `eventStartDate` / `eventEndDate`	string	For `topicType: EVENT`.
`offerCouponCode` / `offerRedeemOnlineUrl` / `offerTermsConditions`	string	For `topicType: OFFER`.
`alertType`	`COVID_19`	For `topicType: ALERT`.

Set the location up in the dashboard first; details/categories/hours are managed via the SDK’s misc.googleBusiness* methods (integrations:trigger gbp:location, gbp:categories).

{ "GOOGLE_BUSINESS": { "text": "Now open Saturdays!", "topicType": "STANDARD", "callToActionType": "LEARN_MORE", "callToActionUrl": "https://example.com" } }

Pinterest — `data.PINTEREST`

Field	Type	Notes
`boardName`	string	The board to pin to.
`uploadIds`	string[]	One image (or video).
`text`	string	The Pin title.
`description`	string	Pin description.
`link`	string (URL)	Where the Pin links to.
`altText`	string	Image alt text.
`note`	string	Private note (not public).
`thumbnail`	string (URL)	Cover image.
`dominantColor`	string	Hex color used as a placeholder before the image loads.

{ "PINTEREST": { "boardName": "Inspiration", "text": "New idea", "uploadIds": ["<id>"], "link": "https://bundle.social" } }

Media notes

Images: JPG / PNG / WEBP / GIF. Video: MP4 / MOV / WEBM. Upload media first (or let the CLI’s -m do it), then put ids in uploadIds (and carouselItems[].uploadId / mediaItems[].uploadId). Large videos can take a while to process server-side after upload — a newly created post may sit in PROCESSING before going POSTED; check with posts:get <id>, and posts:retry <id> for a transient platform failure.

API Documentation

Platforms

Guides

Endpoints

X / Twitter — `data.TWITTER`

Bluesky — `data.BLUESKY`

Mastodon — `data.MASTODON`

Threads — `data.THREADS`

LinkedIn — `data.LINKEDIN`

Facebook (Page) — `data.FACEBOOK`

Instagram — `data.INSTAGRAM`

TikTok — `data.TIKTOK`

YouTube — `data.YOUTUBE`

Reddit — `data.REDDIT`

Discord — `data.DISCORD`

Slack — `data.SLACK`

Google Business Profile — `data.GOOGLE_BUSINESS`

Pinterest — `data.PINTEREST`

Media notes

​X / Twitter — data.TWITTER

​Bluesky — data.BLUESKY

​Mastodon — data.MASTODON

​Threads — data.THREADS

​LinkedIn — data.LINKEDIN

​Facebook (Page) — data.FACEBOOK

​Instagram — data.INSTAGRAM

​TikTok — data.TIKTOK

​YouTube — data.YOUTUBE

​Reddit — data.REDDIT

​Discord — data.DISCORD

​Slack — data.SLACK

​Google Business Profile — data.GOOGLE_BUSINESS

​Pinterest — data.PINTEREST

​Media notes

X / Twitter — `data.TWITTER`

Bluesky — `data.BLUESKY`

Mastodon — `data.MASTODON`

Threads — `data.THREADS`

LinkedIn — `data.LINKEDIN`

Facebook (Page) — `data.FACEBOOK`

Instagram — `data.INSTAGRAM`

TikTok — `data.TIKTOK`

YouTube — `data.YOUTUBE`

Reddit — `data.REDDIT`

Discord — `data.DISCORD`

Slack — `data.SLACK`

Google Business Profile — `data.GOOGLE_BUSINESS`

Pinterest — `data.PINTEREST`

Media notes