# 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.


## Servers
- https://proxy.twilio.com: https://proxy.twilio.com ()


## Authentication methods
- Account sid auth token


## Parameters

### Path parameters
- **ServiceSid** (string)
  The SID parent [Service](https://www.twilio.com/docs/proxy/api/service) resource of the new PhoneNumber resource.


### Body: application/x-www-form-urlencoded (object)

- **Sid** (string)
  The SID of a Twilio [IncomingPhoneNumber](https://www.twilio.com/docs/phone-numbers/api/incomingphonenumber-resource) resource that represents the Twilio Number you would like to assign to your Proxy Service.
- **PhoneNumber** (string(phone-number))
  The phone number in [E.164](https://www.twilio.com/docs/glossary/what-e164) format.  E.164 phone numbers consist of a + followed by the country code and subscriber number without punctuation characters. For example, +14155551234.
- **IsReserved** (boolean)
  Whether the new 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.


## Responses
### 201
Created
#### Headers
- **Access-Control-Allow-Origin** (string)
  Specify the origin(s) allowed to access the resource
- **Access-Control-Allow-Methods** (string)
  Specify the HTTP methods allowed when accessing the resource
- **Access-Control-Allow-Headers** (string)
  Specify the headers allowed when accessing the resource
- **Access-Control-Allow-Credentials** (boolean)
  Indicates whether the browser should include credentials
- **Access-Control-Expose-Headers** (string)
  Headers exposed to the client

#### Body: application/json (object)
- **sid** (string | null)
  The unique string that we created to identify the PhoneNumber resource.
- **account_sid** (string | null)
  The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the PhoneNumber resource.
- **service_sid** (string | null)
  The SID of the PhoneNumber resource's parent [Service](https://www.twilio.com/docs/proxy/api/service) resource.
- **date_created** (string(date-time) | null)
  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) | null)
  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) | null)
  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 | null)
  The string that you assigned to describe the resource.
- **iso_country** (string | null)
  The ISO Country Code for the phone number.
- **capabilities** (object(phone-number-capabilities) | null)
  The capabilities of the phone number.
- **url** (string(uri) | null)
  The absolute URL of the PhoneNumber resource.
- **is_reserved** (boolean | null)
  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.


[Powered by Bump.sh](https://bump.sh)