---
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 must include one of the following scopes: _Voice_ or _Messaging_ or _Fax_.

## Path parameters

- `AccountSid` string, uuid, required

## Request body

- CreateApplicationRequest — Request body for creating an application.
  - `FriendlyName` string, required — A named unique identifier for the resource. Allowed characters: `A-Za-z0-9_-`. Maximum of 100 characters.
  - `MessageStatusCallback` string — If a message's `ApplicationSid` is set to this Application's `Sid`, when a message receives a status change, SignalWire will send a `POST` request to this URL with the message's details.
  - `SmsFallbackMethod` 'GET' | 'POST' — Whether the request to `SmsFallbackUrl` is a `GET` or a `POST`. Default is `POST`.
  - `SmsFallbackUrl` string — The URL SignalWire will request if errors occur when fetching the `SmsUrl`.
  - `SmsMethod` 'GET' | 'POST' — Whether the request to `SmsUrl` is a `GET` or a `POST`. Default is `POST`.
  - `SmsStatusCallback` string — If a message's `ApplicationSid` is set to this Application's `Sid`, when a message receives a status change, SignalWire will send a `POST` request to this URL with the message's details.
  - `SmsUrl` string — The URL to request when an SMS is received.
  - `StatusCallback` string — The URL to pass status updates to the Application.
  - `StatusCallbackMethod` 'GET' | 'POST' — Whether the request to the `StatusCallback` URL is a `GET` or a `POST`. Default is `POST`.
  - `VoiceCallerIdLookup` boolean — Whether or not to look up a caller's ID from the database. Possible values are `true` or `false`. Default is `false`.
  - `VoiceFallbackMethod` 'GET' | 'POST' — Whether the request to `VoiceFallbackUrl` is a `GET` or a `POST`. Default is `POST`.
  - `VoiceFallbackUrl` string — The URL SignalWire will request if errors occur when fetching the `Url`.
  - `VoiceMethod` 'GET' | 'POST' — Whether the request to `VoiceUrl` is a `GET` or a `POST`. Default is `POST`.
  - `VoiceUrl` string — The URL to request when a phone number receives a call or fax.

## Response `200`

The request has succeeded.

- ApplicationResponse — Response containing a single application.
  - `account_sid` string, uuid — The unique identifier for the Account that created this Application.
  - `api_version` string — The version of the SignalWire API.
  - `date_created` string — The date, in RFC 2822 GMT format, this Application was created.
  - `date_updated` string — The date, in RFC 2822 GMT format, this Application was updated.
  - `sid` string, uuid — The unique identifier for the Application.
  - `friendly_name` string — A named unique identifier for the resource. Allowed characters: `A-Za-z0-9_-`. Maximum of 100 characters.
  - `message_status_callback` string — If a message's `ApplicationSid` is set to this Application's `Sid`, when a message receives a status change, SignalWire will send a `POST` request to this URL with the message's details.
  - `sms_fallback_method` string — Whether the request to `SmsFallbackUrl` is a `GET` or a `POST`. Default is `POST`.
  - `sms_fallback_url` string — The URL SignalWire will request if errors occur when fetching the `SmsUrl`.
  - `sms_method` string — Whether the request to `SmsUrl` is a `GET` or a `POST`. Default is `POST`.
  - `sms_status_callback` string — If a message's `ApplicationSid` is set to this Application's `Sid`, when a message receives a status change, SignalWire will send a `POST` request to this URL with the message's details.
  - `sms_url` string — The URL to request when an SMS is received.
  - `status_callback` string — The URL to pass status updates to the Application.
  - `status_callback_method` string — Whether the request to the `StatusCallback` URL is a `GET` or a `POST`. Default is `POST`.
  - `uri` string — The URI for this Application.
  - `voice_caller_id_lookup` boolean — Whether or not to look up a caller's ID from the database. Possible values are `true` or `false`. Default is `false`.
  - `voice_fallback_method` string — Whether the request to `VoiceFallbackUrl` is a `GET` or a `POST`. Default is `POST`.
  - `voice_fallback_url` string — The URL SignalWire will request if errors occur when fetching the `Url`.
  - `voice_method` string — Whether the request to `VoiceUrl` is a `GET` or a `POST`. Default is `POST`.
  - `voice_url` string — The URL to request when a phone number receives a call or fax.

## Other responses

- `400` — 400 Bad Request response.
- `401` — 401 Unauthorized response.

## Changes

- **2026-01-15** `3c88f14db21e` — 1 breaking, 1 warning, 12 info
  - removed the media type `application/x-www-form-urlencoded` from the request body
  - removed the optional property `staus_callback_method` from the response with the `200` status
  - added the media type `application/json` to the request body
  - added the non-success response with the status `400`
  - …10 more

[Change history](https://skmtc.dev/signalwire/apis/compatibility-api/changes/Accounts/:AccountSid/Applications/post.md)

---

[API](https://skmtc.dev/signalwire/apis/compatibility-api.md) · [All operations](https://skmtc.dev/signalwire/apis/compatibility-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/signalwire/compatibility-api/revisions/686ef84c2abc/schema)