Create Outbound Call
vapi_create_callInitiate outbound calls using Vapi voice assistants by specifying phone numbers and optional assistant configurations.
Instructions
Fire an outbound call using a Vapi assistant. Needs your Vapi phone number ID and the customer's number in E.164 format (+14155550100).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"phoneNumberId": "<phoneNumberId>",
"customerNumber": "<customerNumber>"
},
"name": "vapi_create_call"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| phoneNumberId | Yes | Your Vapi phone number ID — find it at dashboard.vapi.ai → Phone Numbers | |
| customerNumber | Yes | The number to call in E.164 format (e.g. +14155550100) | |
| customerName | No | Name of the person being called (assistants can use this) | |
| assistantId | No | ID of a saved assistant to use for this call | |
| metadata | No | Custom data attached to this call — returned on webhooks, great for linking to CRM records | |
| serverUrl | No | Webhook URL to receive events for this call | |
| maxDurationSeconds | No | Max call length in seconds | |
| assistantOverrides | No | Override assistant settings for this call only (e.g. firstMessage, variableValues) |