Twilio API (unofficial showcase)
POST/2010-04-01/Accounts/{AccountSid}/SIP/Domains.json

Create a SIP domain

Creates a SIP domain for an account. Supply DomainName and optionally configure its voice URLs, SIP registration, security, and emergency calling settings.

  • IdempotentThe SDK sends Idempotency-Key, so a retried request is only applied once.

1 parameter · 13 body fields
AccountSidstringrequired
The account identifier, in the format `AC` followed by 32 hexadecimal characters.

SIP domain configuration. DomainName is required; all other fields are optional.

DomainNamestringrequired
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`.
FriendlyNamestringoptional
A descriptive string that you created to describe the resource. It can be up to 64 characters long.
VoiceUrlstringoptional
The URL we should when the domain receives a call.
VoiceMethodstringoptional
The HTTP method we should use to call `voice_url`. Can be: `GET` or `POST`.
Allowed:GETPOST
VoiceFallbackUrlstringoptional
The URL that we should call when an error occurs while retrieving or executing the TwiML from `voice_url`.
VoiceFallbackMethodstringoptional
The HTTP method we should use to call `voice_fallback_url`. Can be: `GET` or `POST`.
Allowed:GETPOST
VoiceStatusCallbackUrlstringoptional
The URL that we should call to pass status parameters (such as call ended) to your application.
VoiceStatusCallbackMethodstringoptional
The HTTP method we should use to call `voice_status_callback_url`. Can be: `GET` or `POST`.
Allowed:GETPOST
SipRegistrationbooleanoptional
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.
EmergencyCallingEnabledbooleanoptional
Whether emergency calling is enabled for the domain. If enabled, allows emergency calls on the domain from phone numbers with validated addresses.
Securebooleanoptional
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.
ByocTrunkSidstringoptional
The SID of the BYOC Trunk(Bring Your Own Carrier) resource that the Sip Domain will be associated with.
EmergencyCallerSidstringoptional
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.

1 status code
201Returns the created SIP domain, including its account and domain identifiers, configuration, and resource URI.
account_sidstringoptional
The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the SipDomain resource.
api_versionstringoptional
The API version used to process the call.
auth_typestringoptional
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_createdstringoptional
The date and time in GMT that the resource was created specified in [RFC 2822](https://www.ietf.org/rfc/rfc2822.txt) format.
date_updatedstringoptional
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_namestringoptional
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_namestringoptional
The string that you assigned to describe the resource.
sidstringoptional
The unique string that that we created to identify the SipDomain resource.
uristringoptional
The URI of the resource, relative to `https://api.twilio.com`.
voice_fallback_methodstringoptional
The HTTP method we use to call `voice_fallback_url`. Can be: `GET` or `POST`.
Allowed:GETPOST
voice_fallback_urlstringoptional
The URL that we call when an error occurs while retrieving or executing the TwiML requested from `voice_url`.
voice_methodstringoptional
The HTTP method we use to call `voice_url`. Can be: `GET` or `POST`.
Allowed:GETPOST
voice_status_callback_methodstringoptional
The HTTP method we use to call `voice_status_callback_url`. Either `GET` or `POST`.
Allowed:GETPOST
voice_status_callback_urlstringoptional
The URL that we call to pass status parameters (such as call ended) to your application.
voice_urlstringoptional
The URL we call using the `voice_method` when the domain receives a call.
subresource_urisobjectoptional
A list of mapping resources associated with the SIP Domain resource identified by their relative URIs.
sip_registrationbooleanoptional
Whether to allow SIP Endpoints to register with the domain to receive calls.
emergency_calling_enabledbooleanoptional
Whether emergency calling is enabled for the domain. If enabled, allows emergency calls on the domain from phone numbers with validated addresses.
securebooleanoptional
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_sidstringoptional
The SID of the BYOC Trunk(Bring Your Own Carrier) resource that the Sip Domain will be associated with.
emergency_caller_sidstringoptional
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.

Error handling

DomainName is required and must use letters, digits, or hyphens and end with sip.twilio.com. The HTTP method fields must be GET or POST, and AccountSid must match the AC prefix followed by 32 hexadecimal characters.