Initiate an outbound phone call via Twilio. The call will be handled by the AI agent assigned to the specified phone number.
Request Body
Your Twilio phone number in E.164 format (e.g., +15551234567). Must be assigned to your account.
The destination phone number in E.164 format (e.g., +15559876543).
Optional UUID of an agent to use instead of the default agent assigned to the phone number.
Optional key-value pairs that will be injected into the agent’s system prompt. Useful for personalizing calls.{
"customer_name": "John",
"appointment_date": "January 15th"
}
Response
Unique identifier for the call (UUID format).
Current status of the call. Will be initiated immediately after creation.
Always phone_call for phone calls.
ID of the agent handling the call.
The caller ID phone number.
The destination phone number.
Always outbound for calls created via API.
curl -X POST https://api.voicy.co/v1/create-phone-call \
-H "Authorization: Bearer voicy_sk_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"from_number": "+15551234567",
"to_number": "+15559876543",
"dynamic_variables": {
"customer_name": "John"
}
}'
{
"call_id": "550e8400-e29b-41d4-a716-446655440000",
"call_status": "initiated",
"call_type": "phone_call",
"agent_id": "550e8400-e29b-41d4-a716-446655440001",
"from_number": "+15551234567",
"to_number": "+15559876543",
"direction": "outbound"
}