Quickstart

Place your first call in 60 seconds

The shortest path: grab an API key from the dashboard, then POST to /api/calls with the number you want to dial. The first call uses Vaani's default flow so you don't have to wire one up before you hear a ring.

Replace vv_live_… with the key you copied from Settings → API keys. Phone numbers are E.164 (+91… for India).

curl https://www.vaanilabs.in/api/calls \
  -H "Authorization: Bearer vv_live_REPLACE_ME" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+919999900000",
    "voice": "female",
    "language": "hi-IN"
  }'

The response includes call.id — pass it to /api/calls/{id} to fetch status, recording, and transcript later.

Want a custom flow? Build one in the flow builder and pass flow_id in the body.

Open in Replit Download as zip Calls API reference

Replit and zip downloads are placeholders for now — bucket wiring is tracked as a follow-up.