create_campaign
Create a campaign with its full step sequence, send window and daily cap.
›Create a 3-step campaign called "Agency Q3" — problem-led first touch, case study on day 3, one-line breakup on day 7. Weekdays only, 9am-5pm Europe/London, 40 sends a day, leave it as draft.
What it does
Creates the campaign and all of its email steps in a single call. Each step carries a subject, a body and a delay in days from the preceding step, so a complete multi-touch sequence is one tool call rather than a wizard.
The send window is set here: an IANA timezone, a comma list of weekdays where 1 is Monday, and start and end hours. Combined with the campaign-wide `daily_limit`, this is where you decide how aggressive the campaign is allowed to be before a single lead is enrolled.
Campaigns are created as `draft` unless you explicitly pass `active`. Drafting first is usually right — it lets you enroll and review before anything leaves the building.
Parameters
| Name | Type | Notes |
|---|---|---|
| name * | string | Internal campaign name. |
| steps * | array | At least one step: subject, body, delay in days. |
| status | enum | `draft` or `active`. Defaults to draft. |
| timezone | string | IANA timezone for the send window. Defaults to UTC. |
| send_days | string | Comma list, 1=Mon..7=Sun. Defaults to '1,2,3,4,5'. |
| send_start_hour | integer | Window opens (1-23). |
| send_end_hour | integer | Window closes (1-24). |
| daily_limit | integer | Campaign-wide sends per day. |
* required · Maps to POST /api/campaigns
What comes back
The created campaign with its steps.
The thing people get wrong
A `send_start_hour` of 0 is coerced to 9. If you want the window to open at midnight, that is not currently expressible — pass 1.
Use it with
More campaigns tools
See all 22 tools and the connection string on the MCP server page.