Programmable voice
Programmable voice lets your own code answer, place and control calls. Pick the model that fits: markup over HTTP, or events and REST actions.
How it works
- 1
Create a voice app
Pick CoXML or Call Control. The kind is fixed once the app is created.
- 2
Answer with your code
CoXML: for each call we fetch your voice URL and run the document it returns. Call Control: events go to your webhook and your server answers with API actions.
- 3
Connect a number
Route a number to the app for inbound calls, or place outbound calls with the Calls API.
Features
- CoXML
- Say, play, gather, dial, record, enqueue, stream and more. CoXML is compatible with TwiML. A fallback URL runs when your voice URL fails.
- Call Control
- Events such as call.answered and call.gather.ended go to your webhook. Answer with actions: speak, gather, bridge, transfer, record, hang up.
- Building blocks
- Conferences, queues, recordings and transcriptions, and answering machine detection.
- Streams and live transcription
- Stream call audio to your WebSocket, and receive live transcripts as events.
- Signed webhooks
- Every webhook and CoXML fetch is signed, and each delivery is logged.
- No-code options
- Flows built on a canvas, and ready-made phone menus, ring groups and voicemail.
- In-app calling
- Browser and mobile SDKs make and receive calls with short-lived access tokens.
- Move existing code
- CoXML is compatible with TwiML and TeXML, and Plivo XML runs too. Compatible callback formats and APIs keep the changes small.
Answer a call
Request in, events out
Questions
CoXML or Call Control?
CoXML when your server returns instructions for each step of the call. Call Control when you want events and to drive the call with API actions.
Can I move code from another provider?
Yes. CoXML is compatible with TwiML, and a compatible callback format and compatibility APIs keep the changes small.
Can I build a call flow without code?
Yes. Use a flow on the canvas, a phone menu, a ring group or voicemail.
Related products
- SIP trunkingSIP trunking connects your PBX, contact center or SIP devices to the phone network, so they can call any US or Canada number and receive calls on your numbers.
- Phone numbersBuy US and Canada phone numbers for voice, local or toll-free, and route each one to a trunk, an app or a flow.
- Bring your own carrierBring your own carrier (BYOC) lets you keep the voice carrier and numbers you already have, and use them with our SIP trunks, voice apps and flows.
Start in the sandbox
Try trunks, voice apps and flows with calls to your own verified numbers, before you add a card.

