posts
posts.delete
Delete a post
Effects: delete, external_api
Delete a post this account published, on any channel that allows it through its API: X, YouTube (the video) and Facebook (a Page post). Name the post by the post_id posts.publish answered or its link (an x.com, youtube.com / youtu.be or numeric facebook.com link), and the account with account_id or the channel. Other channels answer not_supported. Delete only when the user explicitly asks for this post: it cannot be undone.
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
account_id | integer | no | The account that published it (its id from channels.list). |
channel | string | no | The channel, when account_id is omitted and the workspace has one account on it. |
post_id | string | yes | The post to delete: its id (post_id from posts.publish) or its link. |
posts.publish
Publish a post
Effects: send, external_api
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) or 2-10 images (a carousel), 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.
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
account_id | integer | no | The account that publishes (its id from channels.list). |
audience | string | no | Who sees it. OMIT for the channel's default. YouTube: public, unlisted, private; TikTok: public, friends, followers, private; LinkedIn: public, connections. (one of public, connections, followers, friends, unlisted, private) |
channel | string | no | The channel, when account_id is omitted and the workspace has one account on it (instagram, youtube, tiktok, x, threads, linkedin, facebook, skool). |
destination | string | no | Where inside the account it goes, when the channel has places: a Skool community id. |
media_file_ids | array | no | Workspace files to attach, in order (ids from files). |
options | object | 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}, 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. |
reply_to | string | no | A post of this account to answer (a thread of posts on X or Threads). |
text | string | no | The post's text: a caption, a description, a tweet, a post body. |
title | string | no | A title, for channels whose posts have one (YouTube, Skool; TikTok uses text). |