Plan a content campaign (without creating anything)
plan_campaignPlan a run of content the way Autopilot does — WITHOUT creating anything — so you can go through it with the user and change it first. The plan comes from what is working right now in the brand’s niche (Instagram reels on its topic) and, lightly, from what already worked on its own account; each idea has a goal (save, share, follow or lead), a format ("treatment", with how it is built) and, when it models a niche reel, that reel. Costs 25 AI credits. After the user agrees: for each idea, plan_content (its idea, hook and key points as the topic) → generate_image → create_post as a DRAFT on its suggested date; for a reel, get_reel_playbook with that idea. Or, if they just want it done, run_autopilot. For a single post or carousel, plan_content is enough. SPENDS AI CREDITS ONLY WITH confirm: true. Call it first without confirm: nothing runs and nothing is charged, you get the quote (what it will do and the credits). Tell the user, in your own words, exactly that — including the options you chose, so they can change them — and wait for a clear yes before calling again with the same arguments and confirm: true. One yes covers the plan they approved (e.g. every line of an approved voice-over with the chosen voice); anything new or different needs a new yes.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| when | No | When the pieces go: today, tomorrow, this_week, next_week, this_month or next_month. Default today. | |
| count | No | How many ideas (1-20). Each one becomes a piece per account. For a week, 3-5 is typical. | |
| topic | No | Optional brief: a launch, a theme, a date. Leave it out to let the plan come from what is working in the brand’s niche and on its own account — usually the better choice. | |
| confirm | No | true ONLY after the user said yes to the quote (what it does and the credits). Without it nothing runs and nothing is charged. | |
| formats | No | Allowed formats. Default: whatever the accounts’ networks support. | |
| accountIds | Yes | Account ids from list_accounts (the ones to plan for). | |
| workspaceId | No | Workspace to work on (an id from list_workspaces). Not needed when this connection is tied to one workspace, or when you pass an account: the account's workspace is used. | |
| idempotencyKey | No | Optional. A unique id for this action (16-128 chars: letters, digits, _ : . -). If you are unsure whether a call went through (timeout, network error), repeat it with the SAME idempotencyKey and the same arguments: you get the original result and nothing is done twice. |