Skip to main content
POST
/
api
/
v1
/
Account
/
{auth_id}
/
Application
Create an Application
curl --request POST \
  --url https://api.vobiz.ai/api/v1/Account/{auth_id}/Application/ \
  --header 'Content-Type: application/json' \
  --header 'X-Auth-ID: <api-key>' \
  --header 'X-Auth-Token: <api-key>' \
  --data '
{
  "app_name": "My Voice Application",
  "answer_url": "https://example.com/answer",
  "answer_method": "POST"
}
'
{
  "api_id": "aabbccdd-1234-5678-90ab-cdef12345678",
  "app_id": "12345678901234567",
  "message": "created"
}

Documentation Index

Fetch the complete documentation index at: https://docs.vobiz.ai/llms.txt

Use this file to discover all available pages before exploring further.

POST https://api.vobiz.ai/api/v1/Account/{auth_id}/Application/
Creates an application with webhook URLs for call handling. Creating an application is typically the first step - you then attach it to either a number or an endpoint.
Authentication required:
  • X-Auth-ID - Your account Auth ID
  • X-Auth-Token - Your account Auth Token
  • Content-Type: application/json

​
Parameters

FieldTypeRequiredDescription
answer_urlstringYesThe URL fetched when a call executes this application.
app_namestringYesThe name of your application. Allowed values: letters (upper and lower case), numbers (0–9), and only two special characters: - (hyphen) and _ (underscore).
answer_methodstringNoHTTP method used to call answer_url. Defaults to POST.
hangup_urlstringNoURL notified when the call hangs up. Defaults to answer_url.
hangup_methodstringNoHTTP method used to call hangup_url. Defaults to POST.
fallback_answer_urlstringNoInvoked by Vobiz only if answer_url is unavailable or the XML response is invalid. Must return a valid XML response.
fallback_methodstringNoHTTP method used to call fallback_answer_url. Defaults to POST.
message_urlstringNoURL notified when an inbound message is received. Not set by default.
message_methodstringNoHTTP method used to call message_url. Defaults to POST.
default_number_appbooleanNoIf true, newly created numbers without an app_id are routed to this application.
default_endpoint_appbooleanNoIf true, newly created endpoints without an app_id are routed to this application.
subaccountstringNoID of the subaccount that this application is associated with.
application_typestringNoThe type of application (e.g., “voice”, “messaging”).
default_appbooleanNoWhether this is the default application for the account.
enabledbooleanNoWhether the application is enabled. Defaults to true.
log_incoming_messagesbooleanNoIf false, incoming messages to Vobiz phone numbers associated with this application are not logged. Defaults to true.
public_uribooleanNoWhether the application has a public URI.
sip_transfer_methodstringNoHTTP method used for SIP transfer callbacks.
sip_transfer_urlstringNoURL notified during a SIP transfer.
sip_uristringNoSIP URI associated with the application.

​
Request Body

JSON
{
  "app_name": "My Voice App",
  "answer_url": "https://example.com/answer",
  "answer_method": "POST",
  "hangup_url": "https://example.com/hangup",
  "hangup_method": "POST",
  "fallback_answer_url": "https://example.com/fallback",
  "fallback_method": "POST",
  "message_url": "https://example.com/message",
  "message_method": "POST",
  "default_number_app": false,
  "default_endpoint_app": false,
  "sub_account": null
}

​
Response Examples

{
  "api_id": "aabbccdd-1234-5678-90ab-cdef12345678",
  "app_id": "12345678901234567",
  "message": "created"
}

​
cURL Example

cURL
curl -X POST https://api.vobiz.ai/api/v1/Account/{auth_id}/Application/ \
  -H "X-Auth-ID: YOUR_AUTH_ID" \
  -H "X-Auth-Token: YOUR_AUTH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "app_name": "My IVR System",
    "answer_url": "https://myapp.com/ivr/answer",
    "answer_method": "POST"
  }'

Authorizations

​
X-Auth-ID
string
header
required

Your Vobiz account Auth ID

​
X-Auth-Token
string
header
required

Your Vobiz account Auth Token

Path Parameters

​
auth_id
string
required

Your account Auth ID

Example:

"MA_XXXXXX"

Body

application/json
​
app_name
string
required
​
answer_url
string
required
​
answer_method
string
required

Response

Success

​
api_id
string
required
​
app_id
string
required
​
message
string
required