Publish or schedule a post
publish_postPosts a ready video to your connected accounts now, at a time (mode schedule), or in the profile queue. Only after preview_post passed and the user agreed: confirm must be true. For TikTok, pass the tiktok.privacy_level the user chose. idempotency_key: a new unique string per intended post. Repeat the same call with the same key only when it did not answer (timeout, network): you get the same post back, never a second one. A post that came back failed needs a new key; the same key with different arguments is refused (idempotency_mismatch). Counts one post per account against your plan.
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": {
"video_id": "<video_id>",
"profile_id": "<profile_id>",
"account_ids": "<account_ids>",
"caption": "<caption>",
"mode": "<mode>",
"confirm": "<confirm>",
"idempotency_key": "<idempotency_key>"
},
"name": "publish_post"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | Yes | 'now', 'schedule' (needs scheduled_at) or 'queue' (the profile's next free slot) | |
| title | No | Title for titled networks (YouTube); required when one is targeted | |
| No | Required when a Reddit account is targeted | ||
| tiktok | No | TikTok settings, used when a TikTok account is targeted. Ask the user who can view it (privacy_level) before preview_post. | |
| caption | Yes | Post text on every network (on YouTube: the description) | |
| confirm | Yes | Must be true: the user agreed to publish | |
| timezone | No | IANA zone, e.g. Europe/Madrid (default: the server default) | |
| video_id | Yes | A ready video (list_videos / get_video status "ready") | |
| overrides | No | Per network (tiktok, instagram, youtube, facebook, linkedin, threads, reddit, bluesky): a different caption and, on titled networks (YouTube), a different title. Networks left out use caption / title. | |
| profile_id | Yes | The profile to post from (list_profiles) | |
| account_ids | Yes | Accounts of that profile to post to (list_profiles, postable: true) | |
| ai_generated | No | Label the post as AI-generated where the network supports it (default: true for AI swaps, false for your own videos) | |
| scheduled_at | No | Local time YYYY-MM-DDTHH:mm in `timezone` | |
| first_comment | No | Posted as the first comment where the network supports it | |
| idempotency_key | Yes | A new unique string per intended post | |
| youtube_privacy | No | YouTube visibility (default public) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| status | Yes | ||
| app_url | Yes |