schedule_post
Schedule (or publish now) a photo post or a carousel post.
One URL in image_urls makes a single photo post; 2-10 make a carousel,
posted in the order given. Each URL must be publicly fetchable — a direct
link to the file itself, the same rule schedule_reel's source_url follows.
Images and videos are both allowed in a carousel; each item's type is
detected when it's downloaded.
Instead of image_urls, carousel_id posts an AI carousel made in reeldrop,
slides in order (every slide must have its image). Pass one or the other.
Timing: exactly one of scheduled_at (a future, timezone-aware ISO
datetime — get real slots from get_posting_slots rather than guessing) or
publish_now=true. Omit both to save a draft the user can finish in
reeldrop.
caption is required — ask the user for it, or draft options with
generate_reel_captions and let them pick; never invent one and post it.
Up to 5 hashtags. first_comment is posted right after publishing
(Creator plan). automation_id attaches a comment-to-DM automation to
the post once it's live.
For a reel use schedule_reel; for a story use publish_story (now) or schedule_story (later).
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": {
"workspace_id": "<workspace_id>",
"ig_account_id": "<ig_account_id>"
},
"name": "schedule_post"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| caption | No | ||
| hashtags | No | ||
| image_urls | No | ||
| carousel_id | No | ||
| publish_now | No | ||
| client_token | No | ||
| scheduled_at | No | ||
| workspace_id | Yes | ||
| automation_id | No | ||
| first_comment | No | ||
| ig_account_id | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | Yes | ||
| status | Yes | ||
| post_id | Yes | ||
| scheduled_at | No |