Create an Application

Use this endpoint for the Applications method to create a new application within your account.

Parameters

Parameter	Description
FriendlyName Required	The description, up to 64 characters long, of the account.
MessageStatusCallback Optional	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 Optional	Whether the request to SmsFallbackUrl is a GET or a POST. Default is POST.
SmsFallbackUrl Optional	The URL SignalWire will request if errors occur when fetching the SmsUrl.
SmsMethod Optional	Whether the request to SmsUrl is a GET or a POST. Default is POST.
SmsStatusCallback Optional	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 Optional	The URL to request when an SMS is received.
StatusCallback Optional	The URL to pass status updates to the application.
StatusCallbackMethod Optional	Whether the request to the StatusCallback URL is a GET or a POST. Default is POST.
VoiceCallerIdLookup Optional	Whether or not to look up a caller's ID from the database. Possible values are true or false. Default is false.
VoiceFallbackMethod Optional	Whether the request to VoiceFallbackUrl is a GET or a POST. Default is POST.
VoiceFallbackUrl Optional	The URL SignalWire will request if errors occur when fetching the Url.
VoiceMethod Optional	Whether the request to VoiceUrl is a GET or POST. Default is POST.
VoiceUrl Optional	The URL to request when a phone number receives a call or fax.

---

Request

cURL

curl https://example.signalwire.com/api/laml/2010-04-01/Accounts/{AccountSid}/Applications.json \
  -X POST \
  --data-urlencode "FriendlyName=Application1" \
  -u "YourProjectID:YourAuthToken"

Node.js

const { RestClient } = require('@signalwire/compatibility-api')
const client = RestClient('YourProjectID', 'YourAuthToken', { signalwireSpaceUrl: 'example.signalwire.com' })

client.applications
      .create({
         friendlyName: 'Application1'
       })
      .then(application => console.log(application.sid))
      .done();

C#

using System;
using System.Collections.Generic;
using Twilio;
using Twilio.Rest.Api.V2010.Account;

class Program
{
    static void Main(string[] args)
    {
        TwilioClient.Init("YourProjectID", "YourAuthToken", new Dictionary<string, object> { ["signalwireSpaceUrl"] = "{SPACE}.signalwire.com" });

        var application = ApplicationResource.Create(
            friendlyName: "Application1"
        );

        Console.WriteLine(application.Sid);
    }
}

Python

from signalwire.rest import Client as signalwire_client

client = signalwire_client("YourProjectID", "YourAuthToken", signalwire_space_url = 'example.signalwire.com')

application = client.applications \
                    .create(
                         friendly_name='Application1'
                     )

print(application.sid)

Ruby

require 'signalwire/sdk'

@client = Signalwire::REST::Client.new 'YourProjectID', 'YourAuthToken', signalwire_space_url: "example.signalwire.com"

application = @client.applications
                     .create(
                        friendly_name: 'Application1'
                      )

puts application.sid

---

Responses

200 OK

{
  "account_sid": "b3877c40-da60-4998-90ad-b792e98472af",
  "api_version": "2010-04-01",
  "date_created": "Sun, 16 Sept 2018 10:00:00 +0000",
  "date_updated": "Mon, 17 Sept 2018 20:00:00 +0000",
  "friendly_name": "Application1",
  "message_status_callback": "http://www.example.com/sms-status-callback",
  "sid": "b3877c40-da60-4998-90ad-b792e98472af",
  "sms_fallback_method": "GET",
  "sms_fallback_url": "http://www.example.com/sms-fallback",
  "sms_method": "GET",
  "sms_status_callback": "http://www.example.com/sms-status-callback",
  "sms_url": "http://example.com",
  "status_callback": "http://example.com",
  "status_callback_method": "GET",
  "uri": "/api/laml/2010-04-01/Accounts/b3877c40-da60-4998-90ad-b792e98472af/Applications/b3877c40-da60-4998-90ad-b792e98472af.json",
  "voice_caller_id_lookup": false,
  "voice_fallback_method": "GET",
  "voice_fallback_url": "http://www.example.com/voice-callback",
  "voice_method": "GET",
  "voice_url": "http://example.com"
}