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

Create an application

Creates a new application within an account. Configure voice and messaging URLs and callback methods with fields such as VoiceUrl, SmsUrl, and StatusCallback; URL fields must use URI format, and callback methods accept GET or POST. The 201 response returns the created application with its generated SID.

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

1 parameter · 16 body fields
AccountSidstringrequired
The SID of the account creating the application. Must be `AC` followed by 32 hexadecimal characters.

Application configuration for voice, messaging, and status callbacks. All fields are optional.

ApiVersionstringoptional
The API version to use to start a new TwiML session. Can be: `2010-04-01` or `2008-08-01`. The default value is the account's default API version.
VoiceUrlstringoptional
The URL we should call when the phone number assigned to this application 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 retrieving or executing the TwiML requested by `url`.
VoiceFallbackMethodstringoptional
The HTTP method we should use to call `voice_fallback_url`. Can be: `GET` or `POST`.
Allowed:GETPOST
StatusCallbackstringoptional
The URL we should call using the `status_callback_method` to send status information to your application.
StatusCallbackMethodstringoptional
The HTTP method we should use to call `status_callback`. Can be: `GET` or `POST`.
Allowed:GETPOST
VoiceCallerIdLookupbooleanoptional
Whether we should look up the caller's caller-ID name from the CNAM database (additional charges apply). Can be: `true` or `false`.
SmsUrlstringoptional
The URL we should call when the phone number receives an incoming SMS message.
SmsMethodstringoptional
The HTTP method we should use to call `sms_url`. Can be: `GET` or `POST`.
Allowed:GETPOST
SmsFallbackUrlstringoptional
The URL that we should call when an error occurs while retrieving or executing the TwiML from `sms_url`.
SmsFallbackMethodstringoptional
The HTTP method we should use to call `sms_fallback_url`. Can be: `GET` or `POST`.
Allowed:GETPOST
SmsStatusCallbackstringoptional
The URL we should call using a POST method to send status information about SMS messages sent by the application.
MessageStatusCallbackstringoptional
The URL we should call using a POST method to send message status information to your application.
FriendlyNamestringoptional
A descriptive string that you create to describe the new application. It can be up to 64 characters long.
PublicApplicationConnectEnabledbooleanoptional
Whether to allow other Twilio accounts to dial this applicaton using Dial verb. Can be: `true` or `false`.

1 status code
201Returns the created application object, including its account SID, application SID, API version, timestamps, and configured URLs and callbacks.
account_sidstringoptional
The SID of the [Account](https://www.twilio.com/docs/iam/api/account) that created the Application resource.
api_versionstringoptional
The API version used to start a new TwiML session.
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.
friendly_namestringoptional
The string that you assigned to describe the resource.
message_status_callbackstringoptional
The URL we call using a POST method to send message status information to your application.
sidstringoptional
The unique string that that we created to identify the Application resource.
sms_fallback_methodstringoptional
The HTTP method we use to call `sms_fallback_url`. Can be: `GET` or `POST`.
Allowed:GETPOST
sms_fallback_urlstringoptional
The URL that we call when an error occurs while retrieving or executing the TwiML from `sms_url`.
sms_methodstringoptional
The HTTP method we use to call `sms_url`. Can be: `GET` or `POST`.
Allowed:GETPOST
sms_status_callbackstringoptional
The URL we call using a POST method to send status information to your application about SMS messages that refer to the application.
sms_urlstringoptional
The URL we call when the phone number receives an incoming SMS message.
status_callbackstringoptional
The URL we call using the `status_callback_method` to send status information to your application.
status_callback_methodstringoptional
The HTTP method we use to call `status_callback`. Can be: `GET` or `POST`.
Allowed:GETPOST
uristringoptional
The URI of the resource, relative to `https://api.twilio.com`.
voice_caller_id_lookupbooleanoptional
Whether we look up the caller's caller-ID name from the CNAM database (additional charges apply). Can be: `true` or `false`.
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 retrieving or executing the TwiML requested by `url`.
voice_methodstringoptional
The HTTP method we use to call `voice_url`. Can be: `GET` or `POST`.
Allowed:GETPOST
voice_urlstringoptional
The URL we call when the phone number assigned to this application receives a call.
public_application_connect_enabledbooleanoptional
Whether to allow other Twilio accounts to dial this applicaton using Dial verb. Can be: `true` or `false`.

Error handling

The AccountSid path parameter must match the account SID format: AC followed by 32 hexadecimal characters. URL fields must use URI format, and method fields such as VoiceMethod, SmsMethod, and StatusCallbackMethod must be GET or POST.