Activates a virtual number

Method	enable.virtual_numbers
Description	Activates a virtual number
Who has access	Agents and clients

Request parameters

Name	Type	Required	Description
access_token	string	yes	Session key used to authenticate the request
virtual_phone_number	string	no	Virtual phone number to activate. Either virtual_phone_number or number_capacity_ids must be provided.
number_capacity_ids	array of string	no	Array of number-capacity IDs to activate. Either virtual_phone_number or number_capacity_ids must be provided.
number_capacity_component	string	no	Number-capacity component: va or call_tracking. Required when number_capacity_ids is provided.
user_id	number	no	Unique ID of the client user on whose behalf the request is made. Required when an agent makes the request. To retrieve a list of client users, call "get.customer_users".

JSON request structure

{
  "jsonrpc": "2.0",
  "id": "number",
  "method": "enable.virtual_numbers",
  "params": {
    "access_token": "string",
    "user_id": "number",
    "virtual_phone_number": "string"
  }
}

JSON response structure

{
  "jsonrpc": "2.0",
  "id": "number",
  "result": {
    "success": true
  }
}

List of returned errors

Error text	Code	Mnemonic
This action is not available under your current plan. Contact support or update your plan settings in the client area.	-32602	tariff_restrictions
Virtual phone number {virtual_phone_number} was not found.	-32007	virtual_phone_number_not_found

For errors common to all methods, see the Data API — General documentation.