# Create byoc trunk

**POST /v1/ByocTrunks**


BYOC Trunks allow you to bring your own voice carrier to Twilio, enabling your calls to use our Programmable Voice APIs.

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


## Authentication methods
- Account sid auth token


## Parameters



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

- **FriendlyName** (string)
  A descriptive string that you create to describe the resource. It is not unique and can be up to 255 characters long.
- **VoiceUrl** (string(uri))
  The URL we should call when the BYOC Trunk receives a call.
- **VoiceMethod** (string(http-method))
  The HTTP method we should use to call `voice_url`. Can be: `GET` or `POST`.
- **VoiceFallbackUrl** (string(uri))
  The URL that we should call when an error occurs while retrieving or executing the TwiML from `voice_url`.
- **VoiceFallbackMethod** (string(http-method))
  The HTTP method we should use to call `voice_fallback_url`. Can be: `GET` or `POST`.
- **StatusCallbackUrl** (string(uri))
  The URL that we should call to pass status parameters (such as call ended) to your application.
- **StatusCallbackMethod** (string(http-method))
  The HTTP method we should use to call `status_callback_url`. Can be: `GET` or `POST`.
- **CnamLookupEnabled** (boolean)
  Whether Caller ID Name (CNAM) lookup is enabled for the trunk. If enabled, all inbound calls to the BYOC Trunk from the United States and Canada automatically perform a CNAM Lookup and display Caller ID data on your phone. See [CNAM Lookups](https://www.twilio.com/docs/sip-trunking#CNAM) for more information.
- **ConnectionPolicySid** (string)
  The SID of the Connection Policy that Twilio will use when routing traffic to your communications infrastructure.
- **FromDomainSid** (string)
  The SID of the SIP Domain that should be used in the `From` header of originating calls sent to your SIP infrastructure. If your SIP infrastructure allows users to "call back" an incoming call, configure this with a [SIP Domain](https://www.twilio.com/docs/voice/api/sending-sip) to ensure proper routing. If not configured, the from domain will default to "sip.twilio.com".


## 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 BYOC Trunk resource.
- **sid** (string | null)
  The unique string that that we created to identify the BYOC Trunk resource.
- **friendly_name** (string | null)
  The string that you assigned to describe the resource.
- **voice_url** (string(uri) | null)
  The URL we call using the `voice_method` when the BYOC Trunk receives a call.
- **voice_method** (string(http-method) | null)
  The HTTP method we use to call `voice_url`. Can be: `GET` or `POST`.
- **voice_fallback_url** (string(uri) | null)
  The URL that we call when an error occurs while retrieving or executing the TwiML requested from `voice_url`.
- **voice_fallback_method** (string(http-method) | null)
  The HTTP method we use to call `voice_fallback_url`. Can be: `GET` or `POST`.
- **status_callback_url** (string(uri) | null)
  The URL that we call to pass status parameters (such as call ended) to your application.
- **status_callback_method** (string(http-method) | null)
  The HTTP method we use to call `status_callback_url`. Either `GET` or `POST`.
- **cnam_lookup_enabled** (boolean | null)
  Whether Caller ID Name (CNAM) lookup is enabled for the trunk. If enabled, all inbound calls to the BYOC Trunk from the United States and Canada automatically perform a CNAM Lookup and display Caller ID data on your phone. See [CNAM Lookups](https://www.twilio.com/docs/sip-trunking#CNAM) for more information.
- **connection_policy_sid** (string | null)
  The SID of the Connection Policy that Twilio will use when routing traffic to your communications infrastructure.
- **from_domain_sid** (string | null)
  The SID of the SIP Domain that should be used in the `From` header of originating calls sent to your SIP infrastructure. If your SIP infrastructure allows users to "call back" an incoming call, configure this with a [SIP Domain](https://www.twilio.com/docs/voice/api/sending-sip) to ensure proper routing. If not configured, the from domain will default to "sip.twilio.com".
- **date_created** (string(date-time) | null)
  The date and time in GMT that 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 that the resource was last updated specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format.
- **url** (string(uri) | null)
  The absolute URL of the resource.


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