posts_publish
Publish a post (or a video) on a connected account: Instagram, YouTube, TikTok, X, Threads, LinkedIn, Facebook (a Page) or Skool. Name the account with account_id (from channels.list), or name only the channel when the workspace has one account there. What a post may carry differs by channel and the answer says what was refused: YouTube and TikTok take one video, Instagram one image, one video (a Reel), 2-10 images (a carousel) or, with options.media_type "story", one image or video as a story (no text, alt_text, location_id or share_to_feed), X up to 4 media, LinkedIn one image, Facebook text with a link, up to 10 images or one video. Publish only when the user explicitly asks for this post: it is public and cannot be taken back. A failure of type outcome_unknown may already be live: check before publishing again.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | No | The post's text: a caption, a description, a tweet, a post body. | |
| title | No | A title, for channels whose posts have one (YouTube, Skool; TikTok uses text). | |
| channel | No | The channel, when account_id is omitted and the workspace has one account on it (instagram, youtube, tiktok, x, threads, linkedin, facebook, skool). | |
| options | No | The channel's own settings, e.g. YouTube {tags, category_id, made_for_kids}, TikTok {disable_comment, disable_duet, disable_stitch, brand_content_toggle, brand_organic_toggle}, Instagram {alt_text, location_id, share_to_feed, media_type (auto|image|reels|story)}, Threads {reply_control, alt_text}, Facebook {link, scheduled_at (ISO 8601 with offset, 10 minutes to 30 days ahead)}. An option the channel does not have is refused. | |
| audience | No | Who sees it. OMIT for the channel's default. YouTube: public, unlisted, private; TikTok: public, friends, followers, private; LinkedIn: public, connections. | |
| reply_to | No | A post of this account to answer (a thread of posts on X or Threads). | |
| account_id | No | The account that publishes (its id from channels.list). | |
| destination | No | Where inside the account it goes, when the channel has places: a Skool community id. | |
| in_workspace | No | Run this one call in this workspace id instead of the session's. Nothing is stored; other sessions are not affected. | |
| media_file_ids | No | Workspace files to attach, in order (ids from files). |