Latest Legacy

Create an incoming carrier

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 being added. 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.

    Response

    HTTP Status Code: 201

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