Api20100401Account4

Api20100401AddOnResult3

Api20100401Address5

Api20100401AllTime1

Api20100401Application5

Api20100401AssignedAddOn4

Api20100401AssignedAddOnExtension2

Api20100401AuthCallsCredentialListMapping4

Api20100401AuthCallsIpAccessControlListMapping4

Api20100401AuthorizedConnectApp2

Api20100401AuthRegistrationsCredentialListMapping4

Api20100401AvailablePhoneNumberCountry2

Api20100401Balance1

Api20100401Call5

Api20100401CallNotification2

Api20100401CallRecording5

Api20100401CallTranscription2

Api20100401Conference3

Api20100401ConferenceRecording4

Api20100401ConnectApp4

Api20100401Credential5

Api20100401CredentialList5

Api20100401CredentialListMapping4

Api20100401Daily1

Api20100401Data1

Api20100401DependentPhoneNumber1

Api20100401Domain5

Api20100401Event1

Api20100401Feedback1

Api20100401IncomingPhoneNumber5

Api20100401IncomingPhoneNumberLocal2

Api20100401IncomingPhoneNumberMobile2

Api20100401IncomingPhoneNumberTollFree2

Api20100401IpAccessControlList5

Api20100401IpAccessControlListMapping4

Api20100401Key4

Api20100401LastMonth1

Api20100401Local1

Api20100401MachineToMachine1

Api20100401Media1

Api20100401MediaInstance2

Api20100401Member3

Api20100401Message5

Api20100401Mobile1

Api20100401Monthly1

Api20100401National1

Api20100401NewKey1

Api20100401NewSigningKey1

Api20100401Notification2

Api20100401OutgoingCallerId4

Api20100401Participant5

Api20100401Payload3

Api20100401Payment2

Api20100401Queue5

Api20100401Record1

Api20100401Recording3

Api20100401RecordingTranscription3

Api20100401SharedCost1

Api20100401ShortCode3

Api20100401SigningKey4

Api20100401SipIpAddress5

Api20100401Siprec2

Api20100401Stream2

Api20100401ThisMonth1

Api20100401Today1

Api20100401Token1

Api20100401TollFree1

Api20100401Transcription3

Api20100401Trigger5

Api20100401UserDefinedMessage1

Api20100401UserDefinedMessageSubscription2

Api20100401ValidationRequest1

Api20100401Voip1

Api20100401Yearly1

Api20100401Yesterday1

Api20100401Domain

Create a new Domain

Changed on Apr 18, 2024

Create a new Domain

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

Request

Base URL
https://api.twilio.com
URL
https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/SIP/Domains.json
Auth
HTTP basic

Path parameters

AccountSidstring required

The SID of the Account that will create the resource.

Request body application/x-www-form-urlencoded

DomainNamestring required

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.

FriendlyNamestring

A descriptive string that you created to describe the resource. It can be up to 64 characters long.

VoiceUrlstring uri

The URL we should when the domain receives a call.

VoiceMethod'GET' | 'POST' http-method

The HTTP method we should use to call voice_url. Can be: GET or POST.

VoiceFallbackUrlstring uri

The URL that we should call when an error occurs while retrieving or executing the TwiML from voice_url.

VoiceFallbackMethod'GET' | 'POST' http-method

The HTTP method we should use to call voice_fallback_url. Can be: GET or POST.

VoiceStatusCallbackUrlstring uri

The URL that we should call to pass status parameters (such as call ended) to your application.

VoiceStatusCallbackMethod'GET' | 'POST' http-method

The HTTP method we should use to call voice_status_callback_url. Can be: GET or POST.

SipRegistrationboolean

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.

EmergencyCallingEnabledboolean

Whether emergency calling is enabled for the domain. If enabled, allows emergency calls on the domain from phone numbers with validated addresses.

Secureboolean

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.

ByocTrunkSidstring

The SID of the BYOC Trunk(Bring Your Own Carrier) resource that the Sip Domain will be associated with.

EmergencyCallerSidstring

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.

Response

Created

account_sidstring nullable

The SID of the Account that created the SipDomain resource.

api_versionstring nullable

The API version used to process the call.

auth_typestring nullable

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_createdstring date-time-rfc-2822 nullable

The date and time in GMT that the resource was created specified in RFC 2822 format.

date_updatedstring date-time-rfc-2822 nullable

The date and time in GMT that the resource was last updated specified in RFC 2822 format.

domain_namestring nullable

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_namestring nullable

The string that you assigned to describe the resource.

sidstring nullable

The unique string that that we created to identify the SipDomain resource.

uristring nullable

The URI of the resource, relative to https://api.twilio.com.

voice_fallback_method'GET' | 'POST' http-method nullable

The HTTP method we use to call voice_fallback_url. Can be: GET or POST.

voice_fallback_urlstring uri nullable

The URL that we call when an error occurs while retrieving or executing the TwiML requested from voice_url.

voice_method'GET' | 'POST' http-method nullable

The HTTP method we use to call voice_url. Can be: GET or POST.

voice_status_callback_method'GET' | 'POST' http-method nullable

The HTTP method we use to call voice_status_callback_url. Either GET or POST.

voice_status_callback_urlstring uri nullable

The URL that we call to pass status parameters (such as call ended) to your application.

voice_urlstring uri nullable

The URL we call using the voice_method when the domain receives a call.

subresource_urisobject nullable

A list of mapping resources associated with the SIP Domain resource identified by their relative URIs.

sip_registrationboolean nullable

Whether to allow SIP Endpoints to register with the domain to receive calls.

emergency_calling_enabledboolean nullable

Whether emergency calling is enabled for the domain. If enabled, allows emergency calls on the domain from phone numbers with validated addresses.

secureboolean nullable

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_sidstring nullable

The SID of the BYOC Trunk(Bring Your Own Carrier) resource that the Sip Domain will be associated with.

emergency_caller_sidstring nullable

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.

Changes

Apr 18, 2024v2010cf63f47f41aa Revision changes
- breaking
  removed the enum value DELETE of the request property
- breaking
  removed the enum value DELETE of the request property
- breaking
  removed the enum value DELETE of the request property
- breaking
  removed the enum value HEAD of the request property
- breaking
  removed the enum value HEAD of the request property
- breaking
  removed the enum value HEAD of the request property
- breaking
  removed the enum value PATCH of the request property
- breaking
  removed the enum value PATCH of the request property
- breaking
  removed the enum value PATCH of the request property
- breaking
  removed the enum value PUT of the request property
- breaking
  removed the enum value PUT of the request property
- breaking
  removed the enum value PUT of the request property
- info
  removed the DELETE enum value from the response property for the response status
- info
  removed the DELETE enum value from the response property for the response status
- info
  removed the DELETE enum value from the response property for the response status
- info
  removed the HEAD enum value from the response property for the response status
- info
  removed the HEAD enum value from the response property for the response status
- info
  removed the HEAD enum value from the response property for the response status
- info
  removed the PATCH enum value from the response property for the response status
- info
  removed the PATCH enum value from the response property for the response status
- info
  removed the PATCH enum value from the response property for the response status
- info
  removed the PUT enum value from the response property for the response status
- info
  removed the PUT enum value from the response property for the response status
- info
  removed the PUT enum value from the response property for the response status

Operation history

Create a new Domain

Request

Path parameters

Request body application/x-www-form-urlencoded

Response 201Created

Changes

Response