Create post
create_postSaves a post across platforms, one target each with its own caption and media (Media is optional on Facebook, Threads, LinkedIn, X, Bluesky, Google Business Profile: leave media_id and media_ids out for a text post. Instagram, TikTok, YouTube, Pinterest need an image or video. A single Facebook video posted automatically goes out as a Reel, which takes 3 to 60 seconds at 9:16 (90 on a direct connection); check_post warns about any other, which Facebook may refuse, and posting it by hand takes any length.). The post lands as needs approval (or as a draft with submit: false) and publishes at scheduled_at once a person approves it, in show_posts or at approval_url; a brand with auto-approve on approves it at once when every rule passes. Refused with every problem and its fix if anything fails the checks; check_post runs the same checks without saving. Pass idempotency_key so a retried call returns the first post instead of a duplicate. Returns the post with allowed_actions, preview_url and approval_url. Captions may contain {link}, replaced by the brand site link with UTM tags. Facebook and LinkedIn captions must contain {link} unless the first_comment does; Instagram and TikTok must not contain links ("Link in bio" is the usual line). Threads takes one hashtag at most and 5 links a post, Instagram 5 hashtags and 20 @ mentions. Google Business Profile takes 1,500 characters and no hashtags; put its link on the button (google.button) rather than in the text, and keep phone numbers and emails out of it (Google may remove the post). TikTok takes 2,200 characters on a video and 4,000 on a photo post. X counts 280 its own way (a link is 23, an emoji or a Chinese, Japanese or Korean character 2), and X posts with a link ({link}, a URL or a bare domain like example.com) are capped per calendar month (UTC) by plan: get_workspace gives x_link_posts used and left. The brand rules from get_brand apply too. scheduled_at: ISO 8601 with an offset, e.g. 2026-10-06T09:00:00-07:00 for 9am in Los Angeles. A time without an offset is read as UTC. The workspace's time zone is in get_workspace. Or "next_slot": each platform takes the next of its posting times in the next 30 days that no other post of this brand takes on that platform (taken means the exact same time, so a post at 09:05 leaves 09:00 free). A platform's posting times are the brand's own for it (brands[].platform_posting_weeks in get_workspace), else the workspace's posting_week. Platforms on the same times go out together, at the first time free on all of them; one on other times gets its own time on its target. The answer gives the post's time (scheduled_at, local_time) and each target's. Refused when there are no posting times or all are taken.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"title": "<title>",
"brief": "<brief>",
"scheduled_at": "<scheduled_at>",
"targets": "<targets>"
},
"name": "create_post"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| slug | No | Used as utm_content; defaults to the title slugified. Unique per brand. | |
| brand | No | Brand id from get_workspace. Optional when the workspace has one brand. | |
| brief | Yes | What the post is and why, for the person approving it. | |
| title | Yes | Short internal title, for the person reviewing. | |
| submit | No | false keeps it as a draft (call request_approval later). Default true: sent for approval now. | |
| targets | Yes | One per platform. | |
| ai_generated | No | True when the content is AI-made or AI-edited and looks realistic. Instagram gets its AI info label; YouTube gets its altered or synthetic content declaration; TikTok videos a person approved get TikTok's AI-generated label, while TikTok photo posts and auto-approved posts arrive as drafts to label by hand in the app; Pinterest gets its AI modified label; Threads, Facebook, LinkedIn, X and Bluesky get no label. Applies to every target unless one sets its own. | |
| scheduled_at | Yes | ISO 8601 with an offset, e.g. 2026-10-06T09:00:00-07:00 for 9am in Los Angeles. A time without an offset is read as UTC. The workspace's time zone is in get_workspace. Or "next_slot": each platform takes the next of its posting times in the next 30 days that no other post of this brand takes on that platform (taken means the exact same time, so a post at 09:05 leaves 09:00 free). A platform's posting times are the brand's own for it (brands[].platform_posting_weeks in get_workspace), else the workspace's posting_week. Platforms on the same times go out together, at the first time free on all of them; one on other times gets its own time on its target. The answer gives the post's time (scheduled_at, local_time) and each target's. Refused when there are no posting times or all are taken. | |
| idempotency_key | No | Any unique string per intended post, e.g. a UUID. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | Yes | ||
| status | Yes | ||
| post_id | Yes | ||
| targets | Yes | ||
| approval | Yes | ||
| preview_url | Yes | ||
| approval_url | Yes | ||
| scheduled_at | Yes | ||
| allowed_actions | Yes |