---
title: "Update a phone number"
method: PATCH
path: "/phone_numbers/{id}"
tags: ["Phone numbers"]
---

# Update a phone number

`PATCH /phone_numbers/{id}`

Updates a phone number's details.

## Path parameters

- `id` string, required — The ID of the phone number to update.

## Request body

- PhoneNumberUpdateParams — Updates a phone number's details.
  - `campaign_id` string — Campaign ID to attach this number to (`cpn_...`).
  - `name` string — A human-readable name for the phone number.

## Response `200`

Updated phone number

- PhoneNumber — A phone number that can be used to send and receive messages and calls
  - `campaign` PhoneNumberCampaign, required — Campaign attachment details for a domestic local phone number
    - `attachment_status` 'attached' | 'attachment_pending' | 'detached' | 'detachment_pending', required — The current campaign attachment status for this phone number.
    - `id` string, required — The unique identifier of the campaign this phone number is attached to
  - `campaign_id` string, nullable, required — Deprecated. The unique identifier of the campaign this phone number is attached to, if any
  - `id` string, required — Unique identifier for the phone number
  - `name` string, nullable, required — A human-readable name for the phone number
  - `number` string, phone-number, required — The phone number in E.164 format
  - `type` 'local' | 'short_code' | 'toll_free', required — Whether the phone number is local, toll-free, or short code

## Other responses

- `default` — Error

---

[API](https://skmtc.net/surgeapi/apis/surge.md) · [All operations](https://skmtc.net/surgeapi/apis/surge/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/surgeapi/surge/versions/b5b0b6f62245/schema)