Create a recurring Autopilot plan
create_autopilot_planSave an Autopilot setup (accounts, ideas per run, period, format, brief) that runs on its own daily, weekly or monthly at 7:00 in the organization's time zone and leaves the content as DRAFTS (the user gets an email each time; nothing is published). EVERY RUN SPENDS AI CREDITS, like run_autopilot: 25 for the plan + 35 per piece PER ACCOUNT + 20 per image (40 with the speaker's photos). Tell the user the estimated credits per run and per month and get a clear yes before passing confirm: true; without confirm the plan is saved PAUSED. The first run is one cycle after it is created.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Optional name, e.g. "Weekly tips". | |
| when | No | What each run plans for, counted from the day it runs: today, tomorrow, this_week, next_week, this_month or next_month. Default this_week. | |
| 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. | |
| format | No | Force a format, or "auto" (default) to let each run choose per piece. Same values as run_autopilot. | |
| repeat | No | How often it runs. Default weekly. | |
| confirm | No | true ONLY after the user agreed to the estimated credits per run. Needed to create the plan active, to activate it, and to change a plan that is active. | |
| accountIds | Yes | Account ids from list_accounts (the ones to plan for). | |
| keywordCta | No | Allow a "comment WORD" call to action with its comment-to-DM automation. Default false. | |
| withImages | No | Generate images (default true). Images are the biggest part of the cost. | |
| workspaceId | No | Defaults to the workspace this connection is scoped to. | |
| 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. |