---
title: "Changes to Purchase a phone number"
method: POST
path: "/accounts/{account_id}/phone_numbers"
---

# Changes to Purchase a phone number

`POST /accounts/{account_id}/phone_numbers`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 68 revisions.

- **2026-10-16** `912b2a3101fc`: 2 info
- **2026-07-14** `efe962c31996`: 1 info
- **2026-07-14** `645782889002`: 2 info
- **2026-04-22** `844ecbfa0d5b`: 2 info
- **2026-03-11** `347377dfecf0`: 1 info
- **2026-01-26** `376358929111`: 1 warning

## Changes

- **2026-10-16** `912b2a3101fc`: 2 info
  - added the new optional request property `metadata`
  - added the required property `metadata` to the response with the `201` status
- **2026-07-14** `efe962c31996`: 1 info
  - added the new optional request property `phone_number`
- **2026-07-14** `645782889002`: 2 info
  - response property `campaign_id` deprecated
  - added the required property `campaign` to the response with the `201` status
- **2026-04-22** `844ecbfa0d5b`: 2 info
  - added the new optional request property `name`
  - added the required property `name` to the response with the `201` status
- **2026-03-11** `347377dfecf0`: 1 info
  - added the required property `campaign_id` to the response with the `201` status
- **2026-01-26** `376358929111`: 1 warning
  - added the new `short_code` enum value to the `type` response property for the response status `201`

---

[Operation](https://skmtc.dev/surgeapi/apis/surge/docs/accounts/:account_id/phone_numbers/post.md) - [API](https://skmtc.dev/surgeapi/apis/surge.md) - [Page](https://skmtc.dev/surgeapi/apis/surge/changes/accounts/:account_id/phone_numbers/post)