Skip to main content
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.
ActionEndpoint
Enable VoicePOST /sim_cards/{id}/actions/enable_voice
Disable VoicePOST /sim_cards/{id}/actions/disable_voice
Bulk Enable VoicePOST /sim_cards/actions/bulk_enable_voice
Bulk Disable VoicePOST /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:
ActionEndpoint
List NumbersGET /mobile_phone_numbers
Get NumberGET /mobile_phone_numbers/{id}
Update NumberPATCH /mobile_phone_numbers/{id}

Configurable Settings

SettingDescription
call_forwardingForward calls on no-answer, busy, or unconditional
call_recordingRecord inbound, outbound, or both
caller_id_name_enabledEnable CNAM lookup on outbound calls
cnam_listingRegister business name for inbound CNAM display
noise_suppressionAI noise reduction on calls
inbound_call_screeningFilter inbound calls before connecting
connection_idAssociate with a Mobile Voice Connection
customer_referenceYour own reference string
tagsArbitrary tags for filtering
inbound / outboundRouting configuration per direction

Mobile Voice Connection

The voice application attached to a number — controls webhooks, API version, and routing.
ActionEndpoint
List ConnectionsGET /mobile_voice_connections
Create ConnectionPOST /mobile_voice_connections
Get ConnectionGET /mobile_voice_connections/{id}
Update ConnectionPATCH /mobile_voice_connections/{id}
Delete ConnectionDELETE /mobile_voice_connections/{id}

Connection Settings

SettingDescription
webhook_event_urlWhere call events are sent
webhook_event_failover_urlBackup URL if primary fails
webhook_timeout_secsHow long to wait for webhook response
outbound / inboundRouting configuration per direction
activeWhether the connection is active