Sign in

v51

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-02172186551.1 KB
Voice Agents

Place a voice call

Place an outbound voice call answered by the voice agent configured on the sender. Zavu dials the recipient and runs the conversation through its managed voice pipeline (speech recognition, the agent's LLM, and speech synthesis, with real-time interruption handling).

Requirements:

  • The Voice Agents feature must be enabled for your team (otherwise 403).
  • The sender's agent must have voice.enabled set to true.
  • Not available with test-mode API keys.

Billing: Voice calls are billed per minute of connected time plus telephony, deducted from your prepaid balance. A short-duration estimate is reserved when the call is placed; you are charged for the actual duration when the call ends.

post/v1/calls

Request body

tostring required

Recipient phone number in E.164 format.

senderIdstring

Sender profile that places the call. Uses the project's default sender if omitted. The sender's agent must have voice enabled.

greetingstring

Overrides the agent's configured greeting for this call only.

languagestring

Language the agent speaks on this call only, as a BCP-47 tag (en, es, es-ES, pt-BR), or auto to detect the caller's language and follow it. Overrides the agent's configured language for speech recognition, the agent's replies, and the synthesized voice. If the agent uses a custom voice you supplied, that voice is kept and only the language changes. When omitted, the agent's configured language is used.

maxDurationMinutesinteger

Overrides the agent's maximum call duration for this call only.

metadataobject

Arbitrary metadata to associate with the call. Returned on the call object and included in voice webhooks.

Example request

{
  "to": "+56912345678",
  "senderId": "sender_12345",
  "language": "es-ES"
}

Response

Call accepted and dialing.

Example response

{
  "call": {
    "id": "call_abc123",
    "from": "+13125551212",
    "to": "+56912345678"
  }
}