Skip to content
BrainyShorts Docs
Esc
↑↓navigate↵open⌘Jpreview
On this page

Platforms

What each social and article destination accepts, and the rules BrainyShorts enforces before it publishes.

Connect accounts at Dashboard → Social accounts. Each target in a post names a social_account_id and its platform. BrainyShorts checks these rules when you create the post, so a bad target fails with a 400 rather than failing silently later.

Social platforms

Platform platform Media Notes
TikTok tiktok Photo posts (carousel of images), video Media must be on storage.brainyshorts.com
Instagram instagram Single image, 2–10 image carousel, Reels Professional (Business or Creator) accounts only
YouTube youtube Video Publish now or schedule; MP4 uploaded to Brainy Shorts, up to 200 MiB
LinkedIn linkedin Single image, multiple images, MP4 video Personal profiles only
X x Up to 4 images, or 1 MP4 video X bills API access separately

TikTok

  • Publishing or scheduling to TikTok needs settings.privacy_level on the TikTok target, chosen by the account owner. There is no default, so an agent should ask. Values: PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR, SELF_ONLY. Before posting, BrainyShorts checks the choice against the options TikTok offers that account and fails the post with the reason if it is not one of them.
  • Optional switches: disable_comment, disable_duet and disable_stitch (video). Anything the creator turned off in the TikTok app stays off.
  • A post that promotes a business sets is_commercial_content: true with is_your_brand (your own business), is_branded_content (a paid partnership), or both. Branded content cannot be SELF_ONLY.
  • Photo posts pull images by URL, and TikTok only accepts URLs on a verified domain. Upload through /media/uploads and use the returned public_url.
  • TikTok rejects long photo titles, so BrainyShorts strips hashtags from the title and truncates it to 80 characters. Put hashtags in the caption.

Instagram

  • Connect with Instagram Login. The account must be a Business or Creator account; no Facebook Page is needed.
  • Instagram processes media asynchronously, so a delivery can sit in processing for a minute or two before it becomes posted.

YouTube

  • YouTube targets publish now or on a schedule from an MP4 uploaded to Brainy Shorts (reserve the upload, PUT the file, complete it, then use its public_url), up to 200 MiB. They upload as public unless settings.privacy_status is private or unlisted. Brainy Shorts never relays the bytes: a Cloudflare worker streams the stored file to Google.
  • settings also takes category_id, tags, made_for_kids and notify_subscribers.
  • A channel connected before upload access was requested returns 409 YOUTUBE_RECONNECT_REQUIRED; reconnect it with a new connect link.

LinkedIn

  • Posts go to your personal profile. Company Page publishing needs LinkedIn’s separate Community Management API approval and isn’t supported.
  • Videos are capped at 32 MB.

X

  • Captions are limited to 280 characters when any X target is present.
  • Up to 4 images (5 MB each) or 1 video (32 MB).
  • X charges for API access separately from BrainyShorts.

Video covers

  • cover_ms: a whole number of milliseconds from the start of the video. TikTok uses it as video_cover_timestamp_ms and Instagram Reels as thumb_offset.
  • cover_url: the public_url of a JPEG or PNG uploaded to Brainy Shorts. Instagram Reels uses it as the cover (JPEG only) instead of cover_ms. YouTube sets it as the thumbnail after the video is processed (2 MB max). Custom thumbnails need a verified channel; if YouTube refuses, the video still publishes and the delivery’s youtube_thumbnail shows why.
  • LinkedIn and X choose their own cover and ignore both. The create response’s notes lists anything a target did not use.
  • In bulk batches, send cover_ms and cover_asset_id (the asset id of the image) on the item.

Articles

Long-form articles use POST /api/cli/articles or the MCP article tools. A single article can go to several destinations at once.

Destination platform Connection Target settings
DEV.to devto API key none
Hashnode hashnode Personal access token publication_id (required)
Reddit reddit OAuth subreddit (required), flair_id, flair_text, nsfw, spoiler, send_replies
LinkedIn linkedin Existing LinkedIn connection none
X x Existing X connection none
  • DEV.to takes at most 4 tags. Get a key under Settings → Extensions → DEV Community API Keys.
  • Hashnode needs the publication ID from that publication’s dashboard settings on every target.
  • Reddit takes a bare subreddit name (programming, not r/programming). Titles are limited to 300 characters.
  • LinkedIn has no public API for native articles. BrainyShorts publishes a post whose text is the article intro (up to 3,000 characters) with a link card to canonical_url, so set a canonical URL.
  • X publishes a native long-form X Article, not a thread. The account needs an X Premium subscription.

An article counts as published once any destination succeeds, and failed only when all of them fail. Retrying resends only the failed destinations.

Was this page helpful?