make_call
Place an outbound call using a voice AI agent that autonomously manages the conversation with the recipient. Specify the agent, destination number, and caller ID to start.
Instructions
Place an outbound phone call using a voice AI agent.
This connects a real phone call between your AI agent and the destination number. The agent handles the entire conversation autonomously using its configured instructions and voice.
Prerequisites
An agent must exist (use create_agent or list_agents to find one)
A phone number must be provisioned (use list_numbers to find one)
Account must have sufficient balance (use get_balance to check)
Minimum required
Just three fields: which agent talks, who to call, and which number to call from. Everything else is optional.
Per-call customization
Two powerful ways to customize each call without changing the agent:
dynamic_variables — inject values into the agent's prompt template.
If the agent's instructions contain {{customer_name}}, pass:
dynamic_variables={"customer_name": "Alice"}
agent_override — deep-merge config changes over the saved agent for this call only. The agent itself is not modified. Use this to:
Change the prompt for a specific call
Use a different voice or language
Adjust temperature for a sensitive conversation
Override any config section (brain, voice, transcriber, etc.)
Example override:
{"brain": {"instructions": "Special prompt for this call only"}}Args: agent_id: The agent that will handle this call to_number: Destination in E.164 format (+12125551234) number_id: Your phone number ID to call from (from list_numbers) dynamic_variables: Template variables for the agent's prompt caller_id_name: Display name shown to the recipient (max 50 chars) caller_id_number: Override caller ID number (E.164). Defaults to the number_id's phone number if not set. agent_override: Per-call config overrides. Same structure as the agent config from get_agent. Deep-merged over the saved agent — only affects this call.
Returns: call_id for tracking via get_call, success status, and numbers.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| agent_id | Yes | ||
| number_id | Yes | ||
| to_number | Yes | ||
| agent_override | No | ||
| caller_id_name | No | ||
| caller_id_number | No | ||
| dynamic_variables | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||