Make a Call

Initiate an outbound voice call to any phone number.

Endpoint

POST https://api.tryvox.io/v1/voice/accounts/{auth_id}/calls

Request Parameters

Parameter	Type	Required	Description
from	string	yes	Caller ID (E.164 format number you own, e.g., +14155551234)
to	string	yes	Destination number in E.164 format (e.g., +14155556789)
answer_url	string	yes	Webhook URL called when call is answered (must return VoxML)
answer_method	string	no	HTTP method for answer_url (default: POST)
ring_url	string	no	Webhook URL called when call starts ringing
hangup_url	string	no	Webhook URL called when call ends
fallback_url	string	no	Fallback URL if answer_url fails
ring_timeout	integer	no	Ring timeout in seconds (default: 60)
time_limit	integer	no	Maximum call duration in seconds (default: 14400)
machine_detection	string	no	Enable or Disable answering machine detection (default: Disable)

Example Request

curl -X POST https://api.tryvox.io/v1/voice/accounts/your_auth_id/calls \
  -H "Authorization: Bearer tvx_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "from": "+14155551234",
    "to": "+14155556789",
    "answer_url": "https://example.com/answer",
    "answer_method": "POST",
    "ring_url": "https://example.com/ringing",
    "hangup_url": "https://example.com/hangup",
    "ring_timeout": 60,
    "time_limit": 3600,
    "machine_detection": "Enable"
  }'

Response

{
  "request_uuid": "550e8400-e29b-41d4-a716-446655440000",
  "call_uuid": "650e8400-e29b-41d4-a716-446655440000",
  "from": "+14155551234",
  "to": "+14155556789",
  "direction": "outbound",
  "status": "ringing",
  "created_at": "2026-04-09T10:30:00Z"
}

Response Fields

request_uuid - Unique identifier for the API request
call_uuid - Unique identifier for the call (use this for subsequent operations)
from - The caller ID used
to - The destination number
direction - Call direction (outbound)
status - Current call status (ringing, in-progress, completed, failed, etc.)
created_at - Timestamp when the call was created

Webhooks

Answer URL

When the call is answered, TryVox will make a request to your answer_url with call details. Your server must respond with VoxML instructions to control the call.

Ring URL

Called when the call starts ringing. Use this to track call progress.

Hangup URL

Called when the call ends with final call details including duration, end reason, and recording URLs if applicable.

Notes

Phone numbers must be in E.164 format (e.g., +14155551234)
The from number must be a number you own or have verified
The answer_url must be publicly accessible and return valid VoxML
Default time_limit is 4 hours (14400 seconds)
Machine detection adds 1-3 seconds to call connection time

Make a Call

On this page