Platform Options

platform_options is an object keyed by platform that rides along on POST /social/posts, /social/posts/schedule, and bulk rows - the same payload the SmartlyQ composer uses, so anything below works identically from the API. Unknown keys are ignored; you never break a post by sending extra fields.

{
  "content": "Global caption",
  "platforms": ["instagram", "youtube", "reddit"],
  "account_ids": [12, 34, 56],
  "platform_options": {
    "instagram": { "share_to_story": true, "first_comments": ["Link in bio!"] },
    "youtube":   { "title": "My video", "privacy": "unlisted", "tags": ["howto", "smartlyq"] },
    "reddit":    { "subreddit": "test", "title": "Show & tell", "flair_id": "abc-123" }
  }
}

Universal keys (every platform): content - overrides the global caption for that platform only. Scheduling stagger (schedule endpoint): any platform may carry its own scheduled_time - see the note on the schedule endpoint. One call, each network at its own moment.

Per-platform keys

Instagram

Key	Effect
`type`	`post`, `reel` or `story`. Omit it for a normal post. `feed`, `video`, `photo`, `image` are aliases of `post`; `reels` of `reel`; `stories` of `story`. Anything else is rejected with `POST_TYPE_UNSUPPORTED`.
`share_to_story`	Also publish the media as a story
`share_to_feed`	Reels: whether the reel also appears in the main feed (Instagram’s default when omitted)
`first_comments`	Up to 5 comments posted right after publishing (`first_comment` legacy singular works)
`_thumbnail.url` / `_thumbnail.timestamp_ms`	Reel cover image, or cover frame at an offset

YouTube

Key	Effect
`title`	Video title (defaults derived from content)
`privacy`	`public` · `private` · `unlisted`
`made_for_kids`	COPPA audience declaration (default false)
`tags`	Array of video tags/keywords
`category_id`	Numeric YouTube category (default 22, People & Blogs)
`contains_synthetic_media`	AI-generated/altered content disclosure - only sent when you set it
`_thumbnail.url`	Custom video thumbnail

TikTok

Key	Effect
`visibility`	Privacy level (required by TikTok)
`allow_comments` / `allow_duet` / `allow_stitch`	Interaction toggles
`branded_content` / `your_brand`	Commercial-content disclosure flags
`auto_add_music`, `photo_cover_index`, `photo_title`	Photo-post extras
`_thumbnail.timestamp_ms`	Video cover frame offset

Key	Effect
`subreddit`	Target subreddit (overrides the account default)
`title`	Post title
`flair_id` / `flair_text`	Assign a link flair from the subreddit’s catalog (`flair_text` only for editable-text flairs)

Posting a link instead of a self post is automatic when the post carries media suited to it. Check a community first with GET /social/accounts/{account_id}/reddit/subreddits/{subreddit} (rules + can_post verdict).

Facebook

Key	Effect
`type`	`post` (timeline, including video), `reel`, or `story`. Omit it for a normal post - text, image and video all publish to the timeline without it. `feed`, `video`, `photo`, `image`, `text` are accepted as aliases of `post`, `reels` of `reel`, and `stories` of `story`. Anything else is rejected with `POST_TYPE_UNSUPPORTED` and a list of the accepted values.
`first_comments`	Up to 5 comments posted right after publishing (an entry may carry a single image)
`_thumbnail.url`	Video cover image
`link`	Destination URL. On a text-only post Facebook renders it as a preview card. When the post carries media the attachment is the card and Graph has no link parameter, so the URL is appended to the post text instead. Setting this here overrides a request-level `link`.

Stories

type: "story" publishes to the Page’s story tray via Meta’s Page Stories API.

Exactly one photo or one video. Not a carousel, not two images.
No caption. Neither story endpoint accepts a message, description or text overlay, so the post’s text is not published. Put any wording into the image or video itself. The create response carries a warnings entry saying so when a story post has text.
Video: MP4, 9:16, up to 60 seconds, 1080x1920 recommended (540x960 minimum), H.264/H.265, 24-60fps.
Photo: JPEG, PNG, BMP, GIF or TIFF, up to 10MB.
The media must not already have been published. Meta refuses a photo or video that has appeared in a previous post, and refuses media served from its own CDN (fbcdn.net) - host your own copy.
No permanent link. A story lives for 24 hours and has no /posts/{id} page, so post_url comes back null once it expires. The post_id is always returned.
Your Page token needs pages_manage_posts and pages_read_engagement.

title (video/document posts), first_comments, _thumbnail.url. Document (PDF) posts publish via the document pipeline automatically.

X (Twitter)

content override and media_urls per platform. first_comments publish as a reply thread: the first replies to the post, each subsequent one replies to the previous (a chained thread). Each comment may be a plain string, or an object { "text": "...", "media_urls": ["https://..."] } to attach media to that reply - up to 4 images, or one video (X’s per-reply limits). Example:

"twitter": {
  "first_comments": [
    "More in the thread 👇",
    { "text": "Here's the demo", "media_urls": ["https://cdn.example.com/demo.png"] }
  ]
}

Threads

reply_control - who can reply; first_comments.

Google Business

Key	Effect
`post_type`	`STANDARD` · `EVENT` · `OFFER`
`event_title`, `event_start_date`, `event_end_date`, `event_start_time`, `event_end_time`	Event posts
`offer_coupon`, `offer_redeem_url`, `offer_terms`	Offer posts
`cta_type`, `cta_url`	Call-to-action button
`language_code`	Post language

title, board_id, link (destination), alt_text; video cover via a second media item or _thumbnail.url.

Snapchat

surface (story / spotlight), save_to_profile, title (saved stories, ≤45 chars), description + locale (spotlight).

Key	Effect
`parse_mode`	`HTML` · `Markdown` · `MarkdownV2` text formatting
`silent`	Deliver without a notification sound
`disable_link_preview`	Suppress the URL preview (text posts)
`protect_content`	Block forwarding/saving of the message

Tumblr

tags (array).

Bluesky / Discord

content override only - links, mentions and previews are handled automatically.

First comments summary

first_comments (array, max 5) is supported on Facebook, Instagram, X, LinkedIn, Threads, and Reddit. Other platforms ignore it. On X they post as a chained reply thread and each entry may carry media ({ text, media_urls }); on Facebook an entry may carry a single image. Elsewhere they are text only.

SDKs & CLI

Guides

Per-platform keys

Instagram

YouTube

TikTok

Reddit

Facebook

Stories

LinkedIn

X (Twitter)

Threads

Google Business

Pinterest

Snapchat

Telegram

Tumblr

Bluesky / Discord

First comments summary

​Per-platform keys

​Instagram

​YouTube

​TikTok

​Reddit

​Facebook

​Stories

​LinkedIn

​X (Twitter)

​Threads

​Google Business

​Pinterest

​Snapchat

​Telegram

​Tumblr

​Bluesky / Discord

​First comments summary

Per-platform keys

Instagram

YouTube

TikTok

Reddit

Facebook

Stories

LinkedIn

X (Twitter)

Threads

Google Business

Pinterest

Snapchat

Telegram

Tumblr

Bluesky / Discord

First comments summary