All MCP tools
MCP tools · Calls and campaigns
start_campaign
Has a Finn call every contact in an audience from one of the organization's phone numbers, starting now. It spends wallet credit for every call, so it is always held for a person in the organization to approve first. It cannot be scheduled or stopped from here.
- Scope needed
- voice:write
- Changes data
- Yes
- Held for approval
- Can be. The call returns a pending approval and nothing happens until a person in your organization approves it.
- Available to
- Switched on per organization (MCP task tools and call tools)
- Release
- Planned for R2 (2026-11-24)
Spends wallet credit. Always held for approval (a money hold); refused while the organization has holds off.
Inputs
| Name | Type | Description |
|---|---|---|
| org_id | string | Organization id. Leave out when the user belongs to one organization; otherwise the error lists theirs. |
| finn_idrequired | string | The Finn that makes the calls (a UUID, from list_finns). |
| phone_number_idrequired | string | The organization's number to call from (its id). |
| audience_idrequired | string | The audience (list of contacts) to call (its id). |
| max_parallel_calls | number | Calls at once, 1-5. Default 1. |
| recording_enabled | boolean | Record answered calls (charged per call; cannot be changed later). Default false. |