Sample - Twilio API
POST/2010-04-01/Accounts/{AccountSid}/Applications.json

Create a new application

Creates a new application within the specified account. Supply callback URLs and methods to control how the application handles voice calls and SMS messages, and use FriendlyName to label the application.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

1 parameter · 16 body fields
AccountSidstringrequired
The 34-character SID of the account that creates the application. Must match the `AC` account SID format.

Application configuration containing voice, SMS, callback, and identification settings.

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, generated application SID, API version, callback configuration, timestamps, and resource URI.
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

AccountSid must be a 34-character account SID matching the AC prefix pattern. URL fields must use a valid URI, HTTP method fields must be GET or POST, and ApiVersion must be 2010-04-01 or 2008-08-01 when provided.