NumbersMarkdown
Route a number
Routing decides where inbound calls to a number go. A new number is Not routed until you set it.
Set routing
- Go to Numbers.
- Open an active number's ⋮ menu and select Edit routing.
- Pick a destination under Send calls to.
- Select Save routing.
The change applies to new inbound calls within a second.
Destinations
| Option | Calls go to |
|---|---|
| Not routed | Nowhere. Calls are not answered. |
| SIP trunk | A trunk in this project (see SIP trunks). |
| Forward to a phone number | One of your numbers, or Other number…. Both legs are billed: the inbound leg, and the outbound leg at the destination's rate. A forward to another Contactivity number stays on our network and its leg is billed at the SIP & app rate. |
| SIP URI | A SIP address, for example sip:pbx@sip.example.com. |
| CoXML app | A voice app that answers with CoXML instructions. |
| Call Control app | A voice app you control through webhooks and the API. |
| Flow | A flow built in the flow editor. |
| PBX app (IVR / ring group / voicemail) | A PBX app. |
See Voice apps to create apps.
Options
- Ring timeout (s): how long the destination rings. Default 30, from 5 to 600.
- Record calls to this number: records inbound calls. Recordings appear under Voice > Recordings. Not offered for CoXML app and Call Control app: those apps record with
<Record>or therecord_startaction.
The Routing column on the Numbers page shows the current destination, and a recorded badge when recording is on.
Fallbacks
Fallback destinations and traffic splits are set through the API. See the routes guide on the developer site.

