Create, schedule or publish a post
create_postCreate a post for one or more connected networks.
mode "draft" saves it and publishes nothing. mode "schedule" queues it for scheduledAt. mode "now" PUBLISHES IMMEDIATELY to live public accounts. That cannot be undone from here — the post has to be deleted on the network itself. Prefer draft or schedule unless the user has asked for it to go out now.
Posting to X immediately is refused by default because an X post is a billable charge; schedule it instead. Run check_limits first if you are unsure the caption fits.
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": {
"mode": "<mode>"
},
"name": "create_post"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | Yes | ||
| media | No | mediaId values from upload_media or upload_file. The first image is the cover. | |
| caption | No | The caption. A line containing only "---" splits it into a thread on the networks that support one. | |
| igTrial | No | Instagram video reels only: post as a trial reel, shown to non-followers first. "SS_PERFORMANCE" shares it to followers if it performs well; "MANUAL" leaves sharing to the user in the Instagram app. Not for stories or photos. | |
| topicTag | No | Threads only: one topic tag, e.g. "Travel Threads". 1–50 characters, no "." or "&". Other networks ignore it. | |
| igDmReply | No | What igDmKeyword sends back. | |
| placement | No | Instagram and Facebook only: "story" posts the photo or video as a Story (24 hours, no caption shown) instead of to the feed. Default "feed". TikTok and the other networks have no stories API. | |
| platforms | No | Networks to post to, using each one's default account. | |
| thumbnail | No | YouTube video posts only: a JPG or PNG mediaId from upload_file or upload_media, set as the custom thumbnail. Applied once the video is live and YouTube accepts it (often only after processing), retried for about 7 hours. A 9:16 image suits a Short. The channel must be verified for custom thumbnails; get_post_status shows the result. | |
| accountIds | No | Specific account ids from list_accounts. Use this when the user has more than one account on a network. | |
| visibility | No | Who may see the post. Default "public". TikTok: public, followers, friends, private. YouTube: public, unlisted, private. LinkedIn: public, connections. Every other network only posts publicly, so anything but public is refused there. | |
| igDmKeyword | No | Instagram, Facebook and Threads only. Anyone who comments this word on the post gets igDmReply as a private message, once each, within 7 days; on Threads, which has no DMs, as a public reply. Needs igDmReply too. | |
| scheduledAt | No | ISO 8601, in the future. Required when mode is "schedule". | |
| firstComment | No | Posted as the first comment (a reply, on Threads and Bluesky) where supported. When: see firstCommentTrigger. | |
| dmPublicReply | No | Optional. Posted publicly under the comment once the DM is sent, e.g. "Sent you a DM 📩". Leave out for no public reply. | |
| igDmReplyAlts | No | Optional other versions of igDmReply (up to 9). Each commenter gets one of igDmReply and these at random, so a busy post doesn't send the identical DM every time. | |
| organizationId | No | Which organization to act in: an id from list_organizations. Leave out for this connection's default organization. | |
| pinterestBoard | No | Pinterest only: the board to pin to, by name or id. Left out, or no board matches, it goes to the account's first board. | |
| firstCommentTrigger | No | When firstComment goes out. "now" (default): right after the post is live. "after": firstCommentThreshold minutes after it is live (e.g. 240 = 4 hours; at most 7 days). "views" / "likes": once the post has firstCommentThreshold of them — threads and instagram only, read every 5 minutes at first and less often as it ages; if it never gets there in 7 days the comment is not posted and get_post_status says why, unless firstCommentFallbackMinutes is set. A comment never fails the post. | |
| firstCommentThreshold | No | Minutes for "after", the count for "views" / "likes". Required unless the trigger is "now". | |
| firstCommentFallbackMinutes | No | Only with "views" / "likes": whichever comes first. The comment goes out once the post has firstCommentThreshold of them, or this many minutes after it is live, even if the network gives no reading (e.g. threshold 5 + 300 = 5 likes or 5 hours). A whole number, 1 to 10080 (7 days). null removes it. |