Skip to main content
POST
/
api
/
v1
/
account
/
{auth_id}
/
numbers
/
{e164}
/
assign-subaccount
Assign DID to a sub-account
curl --request POST \
  --url https://api.vobiz.ai/api/v1/account/{auth_id}/numbers/{e164}/assign-subaccount \
  --header 'Content-Type: application/json' \
  --header 'X-Auth-ID: <api-key>' \
  --header 'X-Auth-Token: <api-key>' \
  --data '
{
  "sub_account_id": "SA_XXXXXX"
}
'
{
  "api_id": "<string>",
  "error": "<string>",
  "message": "<string>"
}

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.

Assigns a DID from the parent account’s number pool to a sub-account. Once assigned, the sub-account can use the number.
Authenticate with X-Auth-ID / X-Auth-Token (the parent account’s credentials). URL-encode the number in the path — use %2B instead of +.
Moving the number back to the parent pool is subject to a 15-day cool-off — see Unassign DID.

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"

​
e164
string
required

The number in E.164, URL-encoded (use %2B instead of +).

Example:

"%2B919876543210"

Body

application/json
​
sub_account_id
string
required
Example:

"SA_XXXXXX"

Response

DID assigned to the sub-account