---
title: "Add Phone Numbers"
method: POST
path: "/phone_numbers"
tags: ["Phone Number Management"]
deprecated: true
---

# Add Phone Numbers

`POST /phone_numbers`

> **Deprecated.**

Add outbound phone numbers and/or set an inbound phone number.

Inbound phone number is only supported when this capability is enabled for the client. When setting up for the first time (no existing phone masking configuration), the inbound phone number is required. For subsequent requests, the inbound phone number is optional.

Outbound phone numbers are allowed to call consumer phone numbers to reach customers, whereas the inbound phone number receives calls from consumers.

Note: This endpoint is only required for legacy masked phone number leads before 16th April 2026

## Request body

- PhoneNumbersPostRequest
  - `phone_numbers` object, required — Used to configure inbound and outbound phone numbers. At least one of inbound or outbound must be provided.
    - `outbound` string[] — Phone numbers that can call a masked phone number on behalf of a business
    - `inbound` string — Phone number to which calls from consumers will be routed. Only supported when this capability is enabled for the client. Required when setting up for the first time; optional for subsequent requests.

## Response `201`

The phone numbers were successfully added

- PhoneNumbersPostResponse
  - `total` integer — Total number of outbound phone numbers after the operation

## Other responses

- `400` — unresolved $ref
- `401` — unresolved $ref
- `403` — unresolved $ref
- `404` — unresolved $ref
- `429` — unresolved $ref
- `500` — unresolved $ref

---

[API](https://skmtc.net/yelp/apis/businesses.md) · [All operations](https://skmtc.net/yelp/apis/businesses/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/yelp/businesses/revisions/d3f744f55ed7/schema)