Sign in
OpenAPI 3.1.0raw.githubusercontent.com2026-08-191,3412,1385.0 MB

ec31f78cf002

Phone Number Configurations

Update a phone number

Updates the configurable settings of the specified phone number. The response contains the complete updated phone-number representation.

patch/phone_numbers/{id}

Path parameters

idstring required
Example:1293384261075731499

Identifies the resource.

Request body

address_idstring

Identifies the address associated with the phone number.

billing_group_idstring

Identifies the billing group associated with the phone number.

connection_idstring

Identifies the connection associated with the phone number.

customer_referencestring

A customer reference string for customer look ups.

external_pinstring

If someone attempts to port your phone number away from Telnyx and your phone number has an external PIN set, we will attempt to verify that you provided the correct external PIN to the winning carrier. Note that not all carriers cooperate with this security mechanism.

hd_voice_enabledboolean

Indicates whether HD voice is enabled for this number.

idstring

Identifies the type of resource.

tagsstring[]

A list of user-assigned tags to help organize phone numbers.

Example request

{
  "address_id": "dc8f39ac-953d-4520-b93b-786ae87db0da",
  "billing_group_id": "dc8e4d67-33a0-4cbb-af74-7b58f05bd494",
  "connection_id": "dc8e4d67-33a0-4cbb-af74-7b58f05bd494",
  "customer_reference": "customer-reference",
  "external_pin": "1234",
  "hd_voice_enabled": true,
  "id": "dc8e4d67-33a0-4cbb-af74-7b58f05bd494",
  "tags": [
    "tag"
  ]
}

Response

Successful response with details about a phone number.

Example response

{
  "data": {
    "activated_at": "2019-10-23T18:10:00.000Z",
    "billing_group_id": "86f58db9-0fe3-4adc-9d1f-46e66e6e9323",
    "call_forwarding_enabled": true,
    "call_recording_enabled": true,
    "caller_id_name_enabled": true,
    "cnam_listing_enabled": true,
    "connection_id": "1293384261075731499",
    "connection_name": "connection-name",
    "country_iso_alpha2": "US",
    "created_at": "2019-10-23T18:10:00.000Z",
    "customer_reference": "customer-reference",
    "deletion_lock_enabled": false,
    "emergency_address_id": "1315261609962112019",
    "emergency_enabled": true,
    "emergency_status": "active",
    "external_pin": "1234",
    "hd_voice_enabled": true,
    "id": "1293384261075731499",
    "inbound_call_screening": "disabled",
    "messaging_profile_id": "abc85f64-5717-4562-b3fc-2c9600000000",
    "messaging_profile_name": "regional-customers",
    "phone_number": "+19705555098",
    "phone_number_type": "local",
    "purchased_at": "2019-10-23T18:10:00.000Z",
    "record_type": "phone_number",
    "source_type": "number_order",
    "status": "active",
    "t38_fax_gateway_enabled": true,
    "tags": [
      "tag_1",
      "tag_2"
    ],
    "updated_at": "2019-10-24T18:10:00.000Z"
  }
}