Mobile Phone Numbers - Telnyx

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