This guide will serve as instructions for how you can purchase and provision your very first phone number or a new group of numbers in the Ytel API user interface. For instructions on how to do this programatically, please see further below
There are several ways to purchase a number on your account, Ytel provides both a Web interface and API's to you for this purpose.
First we will cover the Web Interface portion.
Steps are as follows,
- Login @ app.ytel.com
- Navigate to the 'Numbers' tab
- Select 'Buy Numbers' from the dropdown
- Filter/Search for your desired Area-code/State
- Click 'Buy' for the desired number ( you can also multi select and purchase more than one at a time)
When you receive a 'Success' message - congratulations! You have purchased your first API number.
Next, we will cover Purchasing via a couple different API's.
First is the 'Buy Number API' (Full doc's @ https://docs.ytel.com/reference#incomingphonebuynumber )
To fully utilize the 'Buy Number' API in a programatic fashion you will first need to run and digest the output of another of our API's. That API is 'View Available Number' Full documentation @
https://docs.ytel.com/reference#incomingphoneavailablenumber
When you run a View Available number API it will return a list of numbers along with some other additional information, You will want to parse 'Phonenumber: {phonenumber}' from the response and feed into your 'Buy Number' API request.
Additionally there is another way to buy numbers. That way is by using our 'Bulk Buy Number' API. ( full documentation found @
https://docs.ytel.com/reference#incomingphonebulkbuy
Simply, you specify the area code and quantity of numbers while specifying "leftover=true" if you intend to buy 'as much as possible' up to your specified quantity. If 'Leftover=false' then we will error the request if the available numbers do not match the requested amount.