Create Application

Create a new Voice Application on the authenticated account.

Endpoint

POST https://api.tryvox.io/v1/voice/applications

Request body

Parameter	Type	Required	Description
`name`	string	yes	Human-friendly label. Doesn't have to be unique.
`voice_url`	string	no	URL TryVox calls when an incoming call needs VoxML. Recommended.
`voice_method`	string	no	`GET` or `POST`. Default: `POST`.
`fallback_url`	string	no	Backup URL if `voice_url` fails (timeout, 5xx, invalid VoxML).
`fallback_method`	string	no	`GET` or `POST`. Default: `POST`.
`hangup_url`	string	no	URL called once the call ends with final disposition.
`hangup_method`	string	no	`GET` or `POST`. Default: `POST`.
`status_callback_url`	string	no	URL called on every status transition.
`status_callback_method`	string	no	`GET` or `POST`. Default: `POST`.

Only name is strictly required. An Application with no URLs is valid but inert — attaching it to a number means calls will hit a dead-end fallback.

Example request

curl -X POST https://api.tryvox.io/v1/voice/applications \
  -u $TRYVOX_AUTH_ID:$TRYVOX_AUTH_TOKEN \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Main IVR",
    "voice_url": "https://your-app.com/answer",
    "voice_method": "POST",
    "fallback_url": "https://your-app.com/fallback",
    "hangup_url": "https://your-app.com/hangup"
  }'

Response

201 Created:

{
  "id": "app_8f7a4b2e91c24f3d9a1e2c4b6d8f0a1c",
  "account_id": "TJab12cd34",
  "name": "Main IVR",
  "answer_url": "https://your-app.com/answer",
  "answer_method": "POST",
  "fallback_url": "https://your-app.com/fallback",
  "hangup_url": "https://your-app.com/hangup",
  "status": "active",
  "created_at": "2026-04-09T10:30:00Z",
  "updated_at": "2026-04-09T10:30:00Z"
}

The response field answer_url corresponds to the voice_url you submitted — the API normalises the term internally. Subsequent updates can use either name; the response always returns answer_url.

Errors

Status	Code	Reason
400	`VALIDATION_FAILED`	`name` missing
401	`INVALID_CREDENTIALS`	Auth ID / Auth Token bad

Create Application

Create Application

Endpoint

Request body

Example request

Response

Errors

Next

On this page