Documentation Index
Fetch the complete documentation index at: https://developers.telnyx.com/llms.txt
Use this file to discover all available pages before exploring further.
When you enable voice on a SIM, Telnyx assigns a Mobile Phone Number — a real +E.164 number. Inbound calls ring the device natively. Outbound calls show your number as caller ID.
Enabling Voice
Voice is enabled per-SIM via action endpoints, not by patching a field.
| Action | Endpoint |
|---|
| Enable Voice | POST /sim_cards/{id}/actions/enable_voice |
| Disable Voice | POST /sim_cards/{id}/actions/disable_voice |
| Bulk Enable Voice | POST /sim_cards/actions/bulk_enable_voice |
| Bulk Disable Voice | POST /sim_cards/actions/bulk_disable_voice |
enable_voice accepts an optional connection_id to associate with a Mobile Voice Connection.
Mobile Phone Number
Once voice is enabled, manage the assigned number via:
| Action | Endpoint |
|---|
| List Numbers | GET /mobile_phone_numbers |
| Get Number | GET /mobile_phone_numbers/{id} |
| Update Number | PATCH /mobile_phone_numbers/{id} |
Configurable Settings
| Setting | Description |
|---|
call_forwarding | Forward calls on no-answer, busy, or unconditional |
call_recording | Record inbound, outbound, or both |
caller_id_name_enabled | Enable CNAM lookup on outbound calls |
cnam_listing | Register business name for inbound CNAM display |
noise_suppression | AI noise reduction on calls |
inbound_call_screening | Filter inbound calls before connecting |
connection_id | Associate with a Mobile Voice Connection |
customer_reference | Your own reference string |
tags | Arbitrary tags for filtering |
inbound / outbound | Routing configuration per direction |
Mobile Voice Connection
The voice application attached to a number — controls webhooks, API version, and routing.
| Action | Endpoint |
|---|
| List Connections | GET /mobile_voice_connections |
| Create Connection | POST /mobile_voice_connections |
| Get Connection | GET /mobile_voice_connections/{id} |
| Update Connection | PATCH /mobile_voice_connections/{id} |
| Delete Connection | DELETE /mobile_voice_connections/{id} |
Connection Settings
| Setting | Description |
|---|
webhook_event_url | Where call events are sent |
webhook_event_failover_url | Backup URL if primary fails |
webhook_timeout_secs | How long to wait for webhook response |
outbound / inbound | Routing configuration per direction |
active | Whether the connection is active |
