Create Voice Route
Create a new voice route to define how inbound calls are handled for numbers assigned to it. Routes support SIP trunk termination, webhook-based IVR, forwarding, and workgroup distribution. Each route returns a unique CRID (Call Route ID) used when provisioning or updating numbers. Workgroups and Schedules can be attached to a route after creation to enable ring groups and business-hours routing.
What this does: Returns the new route’s CallRouteId (CRID-). Store this ID — it is required when provisioning numbers with voice enabled. Configure SIP trunk IPs, forwarding URLs, or workgroups after creation using the update endpoint.
Next steps:
- Assign the route to a number —
POST /v1.0/numbers/provision - Add a workgroup —
POST /v1.0/workgroups
Documentation Index
Fetch the complete documentation index at: https://docs.telegent.com/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
Enter the token obtained from the Authentication endpoint
Body
Friendly name for voice route
"Main SIP Trunk"
Type of voice routing
Trunk, URL, Forward "Trunk"
Webhook URL for voice events
"https://domain.com"
HTTP method for voice URL
GET, POST "POST"
Authentication type
None, Basic, Bearer Username for auth
"admin"
Password or token
"passwordORbearerToken"
Callback URL
"https://apiendpoint.com"
GET, POST "POST"
Primary SIP trunk IP
"20.87.87.87"
Secondary SIP trunk IP
"20.87.87.86"
Primary trunk port
"5061"
Secondary trunk port
"5060"
Primary transport protocol
UDP, TCP, TLS "UDP"
Secondary transport protocol
UDP, TCP, TLS "TCP"
"https://pstn.joonto.com"
"https://pstn2.joonto.com"
Enable primary trunk
true
Enable secondary trunk
false
Priority for trunk 1
10
Weight for trunk 1
10
Priority for trunk 2
20
Weight for trunk 2
20
Header manipulation ID
"HMI8802029"
Enable SIP REFER
true
Caller ID for transfers
"Transferee/Transferor"
Enable symmetric RTP
true
Enable secure trunk
true
Enable PSTN transfer
true
IP whitelist
Enable CNAM lookup
true
Termination URI subdomain
"client"
Enable call streaming
true
WebSocket secure URI
"wss://192.67.88.2"
Enable/disable route
true
Enable intelligent routing features for this voice route
true
Account ID to associate with this voice route
"DID-1e8939ab-3f3c-4db1-89d7-956d80fd793j"
Response
Success — returns the newly created Voice Route ID (CRID)
The response is of type object.