Number Assignment from Inventory

When creating a Tracking Number, you can choose to assign a number found using our Local Numbers or Toll-Free search API.

When creating a number, the following values must be passed:

  • name - a unique name to identify the number for reporting purposes
  • phone_number - the number that was retrieved via the AvailableNumbers resource
  • route_type - how the call should be routed to the Advertiser (see the section on Call Routing for additional information). Basic routing is being used in this example
  • termination_number - a 10 digit phone number where calls should be forwarded to

To create a tracking number using this method, submit the following POST request to the Number resource:

{
    "name": "ABC company",
    "phone_number": "4043411118",
    "call_routes": {
        "route_type": "Basic",
        "termination_number": "4045551234"
    }
}

A successful post will result in the creation of a tracking number:

{
    "id":938472,
    "name": "ABC company",
    "phone_number": "4043411118",
    "call_routes": {
        "route_type": "Basic",
        "termination_number": "4045551234"
    }
}