---
title: "Add a Phone Number to a Service's Proxy Number Pool."
method: POST
path: "/v1/Services/{ServiceSid}/PhoneNumbers"
tags: ["ProxyV1PhoneNumber"]
---

# Add a Phone Number to a Service's Proxy Number Pool.

`POST /v1/Services/{ServiceSid}/PhoneNumbers`

Add a Phone Number to a Service's Proxy Number Pool.

## Path parameters

- `ServiceSid` string, required

## Response `201`

Created

- ProxyV1ServicePhoneNumber
  - `sid` string, nullable — The unique string that we created to identify the PhoneNumber resource.
  - `account_sid` string, nullable — The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the PhoneNumber resource.
  - `service_sid` string, nullable — The SID of the PhoneNumber resource's parent [Service](https://www.twilio.com/docs/proxy/api/service) resource.
  - `date_created` string, date-time, nullable — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time in GMT when the resource was created.
  - `date_updated` string, date-time, nullable — The [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) date and time in GMT when the resource was last updated.
  - `phone_number` string, phone-number, nullable — The phone number in [E.164](https://www.twilio.com/docs/glossary/what-e164) format, which consists of a + followed by the country code and subscriber number.
  - `friendly_name` string, nullable — The string that you assigned to describe the resource.
  - `iso_country` string, nullable — The ISO Country Code for the phone number.
  - `capabilities` object, nullable — The capabilities of the phone number.
    - `fax` boolean
    - `mms` boolean
    - `sms` boolean
    - `voice` boolean
  - `url` string, uri, nullable — The absolute URL of the PhoneNumber resource.
  - `is_reserved` boolean, nullable — Whether the phone number should be reserved and not be assigned to a participant using proxy pool logic. See [Reserved Phone Numbers](https://www.twilio.com/docs/proxy/reserved-phone-numbers) for more information.
  - `in_use` integer — The number of open session assigned to the number. See the [How many Phone Numbers do I need?](https://www.twilio.com/docs/proxy/phone-numbers-needed) guide for more information.

## Changes

- **2024-08-26** (v1) `5d96b79babfd` — 1 info
  - the `in_use` response's property default value `0` was added for the status `201`
- **2023-08-10** (v1) `6b9a26829560` — 1 info
  - api tag `ProxyV1PhoneNumber` added

[Change history](https://skmtc.dev/twilio/apis/proxy-v1/changes/v1/Services/:ServiceSid/PhoneNumbers/post.md)

---

[API](https://skmtc.dev/twilio/apis/proxy-v1.md) · [All operations](https://skmtc.dev/twilio/apis/proxy-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/twilio/proxy-v1/revisions/a2e6d27b3ecd/schema)