Skip to main content
POST
/
call
curl -X POST https://api.nedzo.ai/v1/call \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agentId": "123e4567-e89b-12d3-a456-426614174000",
    "type": "contact",
    "contactId": "456e4567-e89b-12d3-a456-426614174000"
  }'

{
  "conversationId": "123e4567-e89b-12d3-a456-426614174000"
}
​
agentId
string
required
UUID of the agent to use for the call
​
type
string
required
Type of call target. Valid values: contact, phoneNumber
​
variables
object
Custom variables to pass to the assistant. These override contact field values.
​
contactId
string
required
UUID of the contact to call
The agent must have a phone number assigned in Agent Builder > Settings before you can make outbound calls. Calls fail with 400 Bad Request if the agent has no number connected — Nedzo never falls back to another workspace number, since that would surface the wrong caller ID to the recipient.

​
Errors

StatusDetailCause
400Agent does not have a phone number assigned. Please assign a number in Agent Builder > Settings before making outbound calls.The agent has no phone number connected.
400Phone number is not synced to voice engine.The agent’s assigned number hasn’t finished syncing to the voice engine yet.
400Phone number is not active.The agent’s assigned number is in pending or another non-active status.
400Invalid call typetype is something other than contact or phoneNumber.
curl -X POST https://api.nedzo.ai/v1/call \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agentId": "123e4567-e89b-12d3-a456-426614174000",
    "type": "contact",
    "contactId": "456e4567-e89b-12d3-a456-426614174000"
  }'

{
  "conversationId": "123e4567-e89b-12d3-a456-426614174000"
}