# Create a new application within your account

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

Create a new application within your account
An Application instance resource represents an application that you have created with Twilio. An application inside of Twilio is just a set of URLs and other configuration data that tells Twilio how to behave when one of your Twilio numbers receives a call or SMS message.

## 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)

- **ApiVersion** (string)
  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.
- **VoiceUrl** (string(uri))
  The URL we should call when the phone number assigned to this application 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 retrieving or executing the TwiML requested by `url`.
- **VoiceFallbackMethod** (string(http-method))
  The HTTP method we should use to call `voice_fallback_url`. Can be: `GET` or `POST`.
- **StatusCallback** (string(uri))
  The URL we should call using the `status_callback_method` to send status information to your application.
- **StatusCallbackMethod** (string(http-method))
  The HTTP method we should use to call `status_callback`. Can be: `GET` or `POST`.
- **VoiceCallerIdLookup** (boolean)
  Whether we should look up the caller's caller-ID name from the CNAM database (additional charges apply). Can be: `true` or `false`.
- **SmsUrl** (string(uri))
  The URL we should call when the phone number receives an incoming SMS message.
- **SmsMethod** (string(http-method))
  The HTTP method we should use to call `sms_url`. Can be: `GET` or `POST`.
- **SmsFallbackUrl** (string(uri))
  The URL that we should call when an error occurs while retrieving or executing the TwiML from `sms_url`.
- **SmsFallbackMethod** (string(http-method))
  The HTTP method we should use to call `sms_fallback_url`. Can be: `GET` or `POST`.
- **SmsStatusCallback** (string(uri))
  The URL we should call using a POST method to send status information about SMS messages sent by the application.
- **MessageStatusCallback** (string(uri))
  The URL we should call using a POST method to send message status information to your application.
- **FriendlyName** (string)
  A descriptive string that you create to describe the new application. It can be up to 64 characters long.
- **PublicApplicationConnectEnabled** (boolean)
  Whether to allow other Twilio accounts to dial this applicaton using Dial verb. Can be: `true` or `false`.


## 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 Application resource.
- **api_version** (string | null)
  The API version used to start a new TwiML session.
- **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.
- **friendly_name** (string | null)
  The string that you assigned to describe the resource.
- **message_status_callback** (string(uri) | null)
  The URL we call using a POST method to send message status information to your application.
- **sid** (string | null)
  The unique string that that we created to identify the Application resource.
- **sms_fallback_method** (string(http-method) | null)
  The HTTP method we use to call `sms_fallback_url`. Can be: `GET` or `POST`.
- **sms_fallback_url** (string(uri) | null)
  The URL that we call when an error occurs while retrieving or executing the TwiML from `sms_url`.
- **sms_method** (string(http-method) | null)
  The HTTP method we use to call `sms_url`. Can be: `GET` or `POST`.
- **sms_status_callback** (string(uri) | null)
  The URL we call using a POST method to send status information to your application about SMS messages that refer to the application.
- **sms_url** (string(uri) | null)
  The URL we call when the phone number receives an incoming SMS message.
- **status_callback** (string(uri) | null)
  The URL we call using the `status_callback_method` to send status information to your application.
- **status_callback_method** (string(http-method) | null)
  The HTTP method we use to call `status_callback`. Can be: `GET` or `POST`.
- **uri** (string | null)
  The URI of the resource, relative to `https://api.twilio.com`.
- **voice_caller_id_lookup** (boolean | null)
  Whether we look up the caller's caller-ID name from the CNAM database (additional charges apply). Can be: `true` or `false`.
- **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 retrieving or executing the TwiML requested by `url`.
- **voice_method** (string(http-method) | null)
  The HTTP method we use to call `voice_url`. Can be: `GET` or `POST`.
- **voice_url** (string(uri) | null)
  The URL we call when the phone number assigned to this application receives a call.
- **public_application_connect_enabled** (boolean | null)
  Whether to allow other Twilio accounts to dial this applicaton using Dial verb. Can be: `true` or `false`.


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