Latest Legacy

Add a number from your own carrier

Adds a phone number from your own carrier to your account.

API Endpoint

POST https://api.plivo.com/v1/Account/{auth_id}/Number/

Arguments

numbers Requiredstring

A comma-separated list of numbers to be added to the account. These numbers should be configured to point to the SIP address <phone_number\>@sbc.plivo.com. For instance, the phone number 18554675486 should point to 18554675486@sbc.plivo.com.

carrier Requiredstring

The ID of the IncomingCarrier that the number is associated with. For more information, see IncomingCarrier.

region Requiredstring

A free-text field you can use to describe the region of this phone number.

number_type string

The type of the phone number. You can use number_type to differentiate between mobile, local, and toll-free numbers in the account.

Defaults to local.

app_id string

The application to be assigned to the phone number. If not specified, the application selected as the default_number_app of the account is assigned. For more information, refer to the default_number_app argument in application and app_id attribute in application object.

subaccount string

The auth_id of the subaccount to which this number should be added. You can map a phone number to a subaccount only from the main account.

Response

HTTP Status Code: 202

{
  "message": "changed",
  "api_id": "5a9fcb68-582d-11e1-86da-6ff39efcb949"
}