Skip to main content
POST
/
api
/
v1
/
account
/
{auth_id}
/
numbers
/
{number}
/
application
Attach Number to Application
curl --request POST \
  --url https://api.example.com/api/v1/account/{auth_id}/numbers/{number}/application

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.

Link a phone number from your account inventory to a voice application. After attaching, all incoming calls to that number are routed through the application’s answer_url and hangup_url webhooks.
Authentication required:
  • X-Auth-ID - Your account Auth ID
  • X-Auth-Token - Your account Auth Token
  • Content-Type: application/json

​
Path parameters

FieldTypeRequiredDescription
auth_idstringYesYour account Auth ID
numberstringYesThe E.164-formatted phone number, URL-encoded (+ → %2B). Example: %2B1234567890

​
Body parameters

FieldTypeRequiredDescription
application_idstringYesThe app_id of the application to attach to this number.

​
Example request

cURL
curl -X POST "https://api.vobiz.ai/api/v1/account/{auth_id}/numbers/%2B1234567890/application" \
  -H "X-Auth-ID: YOUR_AUTH_ID" \
  -H "X-Auth-Token: YOUR_AUTH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "application_id": "app_xxxxxxxxxxxx"
  }'

​
Response

Success Response (200 OK)
{
  "message": "Number attached to application",
  "number": "+919876543210",
  "application": {
    "answer_method": "POST",
    "answer_url": "https://example.com/answer",
    "api_id": "aabbccdd-1234-5678-90ab-cdef12345678",
    "app_id": "12345678901234567",
    "app_name": "Acme Corp",
    "application_type": "XML",
    "created_at": "2026-04-02 12:11:19.740666+00:00",
    "default_app": false,
    "default_endpoint_app": false,
    "enabled": true,
    "fallback_answer_url": null,
    "fallback_method": "POST",
    "hangup_method": "POST",
    "hangup_url": "https://example.com/answer",
    "log_incoming_message": true,
    "message_method": "POST",
    "message_url": null,
    "public_uri": false,
    "resource_uri": "/v1/Account/MA_XXXXXXXX/Application/12345678901234567/",
    "sip_transfer_method": "POST",
    "sip_transfer_url": null,
    "sip_uri": "sip:12345678901234567@app.vobiz.ai",
    "sub_account": null,
    "updated_at": "2026-04-02 12:11:19.740666+00:00"
  }
}