# Create phone number

**POST /v1/Trunks/{TrunkSid}/PhoneNumbers**


Phone numbers associated with trunks

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


## Authentication methods
- Account sid auth token


## Parameters

### Path parameters
- **TrunkSid** (string)
  The SID of the Trunk to associate the phone number with.


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

- **PhoneNumberSid** (string)
  The SID of the [Incoming Phone Number](https://www.twilio.com/docs/phone-numbers/api/incomingphonenumber-resource) that you want to associate with the trunk.


## 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)
- **account_sid** (string | null)
  The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the PhoneNumber resource.
- **address_requirements** (string)
  Whether the phone number requires an [Address](https://www.twilio.com/docs/usage/api/address) registered with Twilio and, if so, what type. Can be: `none`, `any`, `local`, or `foreign`.
- **api_version** (string | null)
  The API version used to start a new TwiML session.
- **beta** (boolean | null)
  Whether the phone number is new to the Twilio platform. Can be: `true` or `false`.
- **capabilities** (object(string-map) | null)
  The set of Boolean properties that indicate whether a phone number can receive calls or messages.  Capabilities are  `Voice`, `SMS`, and `MMS` and each capability can be: `true` or `false`.
- **date_created** (string(date-time) | null)
  The date and time in GMT when the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format.
- **date_updated** (string(date-time) | null)
  The date and time in GMT when the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format.
- **friendly_name** (string | null)
  The string that you assigned to describe the resource.
- **links** (object(uri-map) | null)
  The URLs of related resources.
- **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.
- **sid** (string | null)
  The unique string that we created to identify the PhoneNumber resource.
- **sms_application_sid** (string | null)
  The SID of the application that handles SMS messages sent to the phone number. If an `sms_application_sid` is present, we ignore all `sms_*_url` values and use those of the application.
- **sms_fallback_method** (string(http-method) | null)
  The HTTP method we use to call `sms_fallback_url`. Can be: `GET` or `POST`.
- **sms_fallback_url** (string(uri) | null)
  The URL that we call using the `sms_fallback_method` when an error occurs while retrieving or executing the TwiML from `sms_url`.
- **sms_method** (string(http-method) | null)
  The HTTP method we use to call `sms_url`. Can be: `GET` or `POST`.
- **sms_url** (string(uri) | null)
  The URL we call using the `sms_method` when the phone number receives an incoming SMS message.
- **status_callback** (string(uri) | null)
  The URL we call using the `status_callback_method` to send status information to your application.
- **status_callback_method** (string(http-method) | null)
  The HTTP method we use to call `status_callback`. Can be: `GET` or `POST`.
- **trunk_sid** (string | null)
  The SID of the Trunk that handles calls to the phone number. If a `trunk_sid` is present, we ignore all of the voice URLs and voice applications and use those set on the Trunk. Setting a `trunk_sid` will automatically delete your `voice_application_sid` and vice versa.
- **url** (string(uri) | null)
  The absolute URL of the resource.
- **voice_application_sid** (string | null)
  The SID of the application that handles calls to the phone number. If a `voice_application_sid` is present, we ignore all of the voice URLs and use those set on the application. Setting a `voice_application_sid` will automatically delete your `trunk_sid` and vice versa.
- **voice_caller_id_lookup** (boolean | null)
  Whether we look up the caller's caller-ID name from the CNAM database ($0.01 per look up). Can be: `true` or `false`.
- **voice_fallback_method** (string(http-method) | null)
  The HTTP method that we use to call `voice_fallback_url`. Can be: `GET` or `POST`.
- **voice_fallback_url** (string(uri) | null)
  The URL that we call using the `voice_fallback_method` when an error occurs retrieving or executing the TwiML requested by `url`.
- **voice_method** (string(http-method) | null)
  The HTTP method we use to call `voice_url`. Can be: `GET` or `POST`.
- **voice_url** (string(uri) | null)
  The URL we call using the `voice_method` when the phone number receives a call. The `voice_url` is not be used if a `voice_application_sid` or a `trunk_sid` is set.


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