schedule_reel
Schedule, or immediately publish, a single Instagram reel.
Provide exactly one of source_url or video_token: source_url is a direct, publicly-fetchable link to the video file itself — e.g. a Google Drive file's webContentLink with the file shared as "Anyone with the link". Do NOT pass base64 file content here (for example from a Drive connector's download_file_content tool) — this tool downloads the video server-side from the URL you provide. video_token is the value generate_reel_captions returned for a video already uploaded through that tool — pass it here to reuse that upload instead of re-fetching source_url.
Provide exactly one of scheduled_at (a timezone-aware datetime in the future) or publish_now=true. publish_now sends the reel straight into the publish pipeline instead of scheduling it for later — the result's status will be "publishing", not "scheduled", since it isn't confirmed live on Instagram yet when this call returns.
caption and hashtags are both required — this tool refuses a blank caption or an empty hashtags list rather than posting one silently. If you don't already have a caption for this video, call generate_reel_captions first (same source_url/video_token), show the user all 3 options, and let them pick — or ask whether they'd rather you choose — then retry this call with that caption and its recommended_hashtags.
cover_choice is also required, and must be exactly "instagram_default" (Instagram auto-generates the cover — leave cover_url unset) or "custom" (you're supplying a specific image — cover_url must then be a public URL, or upload one via get_video_upload_url if it's local). Ask the user which they want; don't decide silently. There's no third "use the video's first frame" option — reeldrop has no way to extract one, and instagram_default is the closest available equivalent.
automation_id (optional) links a DM/comment automation that was created with post_target="attach_later" (create_automation) to this reel the moment it's scheduled — the one-call version of what would otherwise take a follow-up update_scheduled_post call.
trial_reel=true publishes it as an Instagram trial reel: shown to non-followers first, kept off the profile grid until it is shared with followers. trial_graduation decides how that sharing happens: "MANUAL" (the default; the user shares it from the Instagram app when they choose) or "SS_PERFORMANCE" (Instagram shares it automatically if it performs well). Ask the user which they want. No API can share a trial reel to followers later, so reeldrop can't do it for them. A trial reel uses the plan's monthly trial-reel allowance (get_plan_usage). Track it with get_trial_reel_analytics.
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_reel"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| caption | No | ||
| hashtags | No | ||
| cover_url | No | ||
| source_url | No | ||
| trial_reel | No | ||
| publish_now | No | ||
| video_token | No | ||
| client_token | No | ||
| cover_choice | No | ||
| scheduled_at | No | ||
| workspace_id | Yes | ||
| automation_id | No | ||
| ig_account_id | Yes | ||
| share_to_feed | No | ||
| allow_comments | No | ||
| allow_remixing | No | ||
| trial_graduation | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | ||
| index | No | ||
| status | Yes | ||
| post_id | No | ||
| source_url | No | ||
| scheduled_at | No |