Quickstart

Get up and running with TryVox in under 5 minutes. This guide walks you through making your first AI-powered voice call.

Prerequisites

• A TryVox account (sign up at tryvox.io)
• curl or any HTTP client
• A publicly reachable URL that can serve a VoxML response (or use a tunnel like ngrok)

Step 1: Get Your API Credentials

1. Log in to the TryVox Dashboard
2. Navigate to Settings → API Keys
3. Click Create API Key
4. Copy both values:
   • Auth ID — TJ followed by 8 hex chars (e.g., TJab12cd34)
   • Auth Token — 32 hex chars (e.g., 1f2e3d4c5b6a7988a1b2c3d4e5f60718)

The Auth Token is shown once. Store it somewhere safe — if you lose it, you'll have to rotate.

All requests authenticate with HTTP Basic auth: Auth ID as the username, Auth Token as the password. With curl that's the -u flag.

export TRYVOX_AUTH_ID="TJab12cd34"
export TRYVOX_AUTH_TOKEN="1f2e3d4c5b6a7988a1b2c3d4e5f60718"

Step 2: Provision a Phone Number

Before making calls, you need a phone number. Purchase one from inventory:

curl -X POST https://api.tryvox.io/v1/account/$TRYVOX_AUTH_ID/numbers/purchase-from-inventory \
  -u $TRYVOX_AUTH_ID:$TRYVOX_AUTH_TOKEN \
  -H "Content-Type: application/json" \
  -d '{
    "country": "IN",
    "type": "local"
  }'

Response:

{
  "data": {
    "e164": "+919876543210",
    "country": "IN",
    "status": "active",
    "type": "local",
    "capabilities": ["voice", "sms"]
  }
}

Your number is active and can be used as the from number for outbound calls on the same account.

Step 3: Make an Outbound Call

curl -X POST https://api.tryvox.io/v1/voice/accounts/$TRYVOX_AUTH_ID/calls \
  -u $TRYVOX_AUTH_ID:$TRYVOX_AUTH_TOKEN \
  -H "Content-Type: application/json" \
  -d '{
    "from": "+919876543210",
    "to": "+14155551234",
    "answer_url": "https://your-app.com/answer"
  }'

Parameters:

• from — your account-owned number from Step 2
• to — the destination phone number, E.164 format
• answer_url — your webhook URL that returns VoxML when the call is answered

Response:

{
  "data": {
    "request_uuid": "550e8400-e29b-41d4-a716-446655440000",
    "account_id": "TJab12cd34",
    "auth_id": "TJab12cd34",
    "from": "+919876543210",
    "to": "+14155551234",
    "direction": "outbound",
    "status": "queued",
    "start_time": "2026-04-09T10:30:00Z",
    "duration": 0,
    "billsec": 0
  }
}

Step 4: Control the Call with VoxML

When the call is answered, TryVox POSTs to your answer_url. Your server should respond with VoxML instructions to control the call:

{
  "voxml_version": "1.0",
  "instructions": [
    {
      "verb": "Say",
      "text": "Hello! I am your AI assistant.",
      "engine": "google",
      "language": "en-IN"
    },
    {
      "verb": "Stream",
      "url": "wss://your-app.com/ai-agent",
      "track": "inbound_track"
    }
  ]
}

What this does:

1. Say — speaks a TTS greeting using Google's TTS engine
2. Stream — opens a WebSocket and sends live call audio to your AI or speech service

TryVox executes the instructions in order, streaming the caller's audio to your WebSocket so your LLM agent can respond in real time.

Next Steps

You've made your first call. Here's what to explore next:

• Voice API Reference — full voice API capabilities
• VoxML Guide — every VoxML verb with examples
• Verified Caller IDs — manage caller IDs at scale
• Webhooks — handle call lifecycle events
• Verify API — send OTPs over SMS, voice, WhatsApp, or email

Need Help?

• Check out our example applications
• Join our Discord community
• Email us at team@tryvox.io