# Create a new Domain

**POST /2010-04-01/Accounts/{AccountSid}/SIP/Domains.json**

Create a new Domain
Custom DNS hostnames that can accept SIP traffic

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


## Authentication methods
- Account sid auth token


## Parameters

### Path parameters
- **AccountSid** (string)
  The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that will create the resource.


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

- **DomainName** (string)
  The unique address you reserve on Twilio to which you route your SIP traffic. Domain names can contain letters, digits, and "-" and must end with `sip.twilio.com`.
- **FriendlyName** (string)
  A descriptive string that you created to describe the resource. It can be up to 64 characters long.
- **VoiceUrl** (string(uri))
  The URL we should when the domain 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`.
- **VoiceStatusCallbackUrl** (string(uri))
  The URL that we should call to pass status parameters (such as call ended) to your application.
- **VoiceStatusCallbackMethod** (string(http-method))
  The HTTP method we should use to call `voice_status_callback_url`. Can be: `GET` or `POST`.
- **SipRegistration** (boolean)
  Whether to allow SIP Endpoints to register with the domain to receive calls. Can be `true` or `false`. `true` allows SIP Endpoints to register with the domain to receive calls, `false` does not.
- **EmergencyCallingEnabled** (boolean)
  Whether emergency calling is enabled for the domain. If enabled, allows emergency calls on the domain from phone numbers with validated addresses.
- **Secure** (boolean)
  Whether secure SIP is enabled for the domain. If enabled, TLS will be enforced and SRTP will be negotiated on all incoming calls to this sip domain.
- **ByocTrunkSid** (string)
  The SID of the BYOC Trunk(Bring Your Own Carrier) resource that the Sip Domain will be associated with.
- **EmergencyCallerSid** (string)
  Whether an emergency caller sid is configured for the domain. If present, this phone number will be used as the callback for the emergency call.


## 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 SipDomain resource.
- **api_version** (string | null)
  The API version used to process the call.
- **auth_type** (string | null)
  The types of authentication you have mapped to your domain. Can be: `IP_ACL` and `CREDENTIAL_LIST`. If you have both defined for your domain, both will be returned in a comma delimited string. If `auth_type` is not defined, the domain will not be able to receive any traffic.
- **date_created** (string(date-time-rfc-2822) | 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-rfc-2822) | 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.
- **domain_name** (string | null)
  The unique address you reserve on Twilio to which you route your SIP traffic. Domain names can contain letters, digits, and "-" and must end with `sip.twilio.com`.
- **friendly_name** (string | null)
  The string that you assigned to describe the resource.
- **sid** (string | null)
  The unique string that that we created to identify the SipDomain resource.
- **uri** (string | null)
  The URI of the resource, relative to `https://api.twilio.com`.
- **voice_fallback_method** (string(http-method) | null)
  The HTTP method we use to call `voice_fallback_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_method** (string(http-method) | null)
  The HTTP method we use to call `voice_url`. Can be: `GET` or `POST`.
- **voice_status_callback_method** (string(http-method) | null)
  The HTTP method we use to call `voice_status_callback_url`. Either `GET` or `POST`.
- **voice_status_callback_url** (string(uri) | null)
  The URL that we call to pass status parameters (such as call ended) to your application.
- **voice_url** (string(uri) | null)
  The URL we call using the `voice_method` when the domain receives a call.
- **subresource_uris** (object(uri-map) | null)
  A list of mapping resources associated with the SIP Domain resource identified by their relative URIs.
- **sip_registration** (boolean | null)
  Whether to allow SIP Endpoints to register with the domain to receive calls.
- **emergency_calling_enabled** (boolean | null)
  Whether emergency calling is enabled for the domain. If enabled, allows emergency calls on the domain from phone numbers with validated addresses.
- **secure** (boolean | null)
  Whether secure SIP is enabled for the domain. If enabled, TLS will be enforced and SRTP will be negotiated on all incoming calls to this sip domain.
- **byoc_trunk_sid** (string | null)
  The SID of the BYOC Trunk(Bring Your Own Carrier) resource that the Sip Domain will be associated with.
- **emergency_caller_sid** (string | null)
  Whether an emergency caller sid is configured for the domain. If present, this phone number will be used as the callback for the emergency call.


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