HTTP Status Code: 201
{
    "api_id": "65368fb6-5060-11e4-8a4a-123140008edf",
    "carrier_id": "13455781930894",
    "message": "created"
}

This API lets you add a new incoming carrier to your Plivo account.

API Endpoint

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

Arguments

name
Required

The name of the carrier. You can use any name.
Allowed Values:

  • Alphabets (upper case and lower case)
  • Numbers (0-9).
  • Only 2 special characters, i.e. ”-” (hyphen) and ”_” (underscore)
  • ip_set
    Required

    Comma-separated list of IP addresses from which calls belonging to the carrier will reach Plivo. Plivo checks this list to determine whether to allow incoming calls into Plivo’s servers, and will not accept calls that come from IP addresses not on this list. The complete set of IP addresses is replaced when you call this API.

    HTTP Status Code: 201
    {
        "api_id": "65368fb6-5060-11e4-8a4a-123140008edf",
        "carrier_id": "13455781930894",
        "message": "created"
    }