---
title: "Create an Application"
method: POST
path: "/Accounts/{AccountSid}/Applications"
tags: ["Applications"]
---

# Create an Application

`POST /Accounts/{AccountSid}/Applications`

Create an Application.

#### Permissions

The API token used to authenticate must have the following scope(s) enabled to make a successful request: _Voice_ or _Messaging_ or _Fax_.

[Learn more about API scopes](/docs/platform/your-signalwire-api-space).

## Path parameters

- `AccountSid` string, uuid, required — Universal Unique Identifier.

## Response `201`

Response containing a newly created application.

- Application — Application model representing a cXML application.
  - `sid` string, uuid, required — Universal Unique Identifier.
  - `account_sid` string, uuid, required — Universal Unique Identifier.
  - `api_version` string, required — The version of the SignalWire API.
  - `date_created` string, required — The date, in RFC 2822 GMT format, this Application was created.
  - `date_updated` string, required — The date, in RFC 2822 GMT format, this Application was updated.
  - `friendly_name` string, required — A named unique identifier for the resource.
  - `uri` string, required — The URI for this Application.
  - `voice_url` string, nullable, required — The URL to request when a phone number receives a call or fax.
  - `voice_method` string, nullable, required — Whether the request to `VoiceUrl` is a `GET` or a `POST`. Default is `POST`.
  - `voice_fallback_url` string, nullable, required — The URL SignalWire will request if errors occur when fetching the `VoiceUrl`.
  - `voice_fallback_method` string, nullable, required — Whether the request to `VoiceFallbackUrl` is a `GET` or a `POST`. Default is `POST`.
  - `status_callback` string, nullable, required — The URL to pass status updates to the Application.
  - `status_callback_method` string, nullable, required — Whether the request to the `StatusCallback` URL is a `GET` or a `POST`. Default is `POST`.
  - `voice_caller_id_lookup` boolean, nullable, required — Whether or not to look up a caller's ID from the database. Always null.
  - `sms_url` string, nullable, required — The URL to request when an SMS is received.
  - `sms_method` string, nullable, required — Whether the request to `SmsUrl` is a `GET` or a `POST`. Default is `POST`.
  - `sms_fallback_url` string, nullable, required — The URL SignalWire will request if errors occur when fetching the `SmsUrl`.
  - `sms_fallback_method` string, nullable, required — Whether the request to `SmsFallbackUrl` is a `GET` or a `POST`. Default is `POST`.
  - `sms_status_callback` string, nullable, required — The URL to receive status updates for messages sent via this Application.
  - `sms_status_callback_method` string, nullable, required — Whether the request to `SmsStatusCallback` is a `GET` or a `POST`. Default is `POST`.
  - `message_status_callback` string, nullable, required — The URL to receive status updates for messages sent via this Application.

## Other responses

- `400` — The request was invalid or cannot be processed. Check the error details for more information.
- `401` — Authentication failed. Please verify your credentials and try again.
- `422` — The request could not be processed due to validation errors. Check the error details for more information.

---

[API](https://skmtc.net/signalwire/apis/compatibility-api.md) · [All operations](https://skmtc.net/signalwire/apis/compatibility-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/signalwire/compatibility-api/versions/e6faba43acd7/schema)