Skip to main content
POST
Make phone call
Places a real outbound call. The agent answers and drives the conversation.
This places a real phone call and bills your wallet. Make sure your wallet has balance and use a number you control while testing.

Body parameters

string
required
Agent that will handle the call, as a UUID
string
required
ID of a voice number already registered to your tenant (not a raw phone number) — see Purchase Phone Numbers
string
required
Destination number, E.164 format — e.g. +14155551234
string
Your tenant ID. Omit it when authenticating with an API key — the tenant is taken from the key itself
string
UUID of an existing contact to attribute the call to
string
Campaign reference
string
Campaign attempt reference
object
Arbitrary key/value data stored with the call session

Response

Don’t know your voiceNumberId? List your registered numbers first with GET /voice-numbers.