Buying and exchanging numbers is a key component to API on Below we will be going over how to buy and release numbers from the app.ytel as well as the different types of numbers. 

Firs thing you will need to do is log into your account. To do this navigate in your browser to and log in with your credentials. If you have not set up an account make sure to click the sign up sign up now button. Make sure you select the end user agreement button.

Next, you will want to make sure that you are on the API icon and then go to "Numbers" and "Purchase". For another option, you can click on the "Get a number" on the center of the main dashboard. 

From here you will be able to select if you want a type of number, the region, area code and the display then you would hit search. Below are the definition  and use case to each option.

Type- This will let you toggle between local and toll free numbers.
Region- This option will let you select the state you want to search for numbers in.
Area Codes- If you select a state this will allow you to use the drop down to select are codes in that state.
Display- This option will display the amount of area codes you have selected. Keep in mind if you have a lot of area codes selected this may take some time to propagate. 

After you choose your options hit the search button on the right and it will display the numbers in your search below the options. 

You can use the select all button on the upper right of the numbers or you can select them one by one. Here you can also see if the number is sms,mms, and voice enabled. When purchasing a number keep in mind that you can utilize sms enabled numbers as an inbound communication and have conversations with customers that text your lines. To explore this deeper check out this article.

Link for using Inbox.  

Select a number and then hit the Purchase Icon that will appear above the numbers. 

You will then be taken to the Purchase confirmation screen. You will select a number set for the DID to go into and see the total price of the purchase. Once you are done click the confirm button to make the purchase.

You have now completed the purchase and you can see your number or numbers in the numbers and manage numbers section. 

What’s a Number Set?
A way of organizing Ytel phone numbers that serve the same purpose.

When should I put my Ytel phone numbers into a Number Set?
It’s a good idea to put your Ytel phone numbers into a number set whenever you need to send a text message to a large number of recipients. You’ll also want to use number sets when you have multiple phone numbers that share the same configuration settings.

For example, say you need to send out appointment reminder text messages to 250-500 recipients per day. We strongly recommend that you avoid using just one local phone number to send these messages because sending text messages to over 200 recipients in one day could cause carriers to become suspicious and block your messages. To help prevent that, we recommend you use at least 3 different local phone numbers (500 max potential recipients per day divided by 200 contact per day = 2.5 minimum phone numbers) so your phone numbers will stay under the 200 recipients per day per phone number recommendation. But how do you go about determining which Ytel phone number to use for each message? You don’t want to be manually assigning them. Asking your developers to write code to handle this logic makes sense but will delay your go live date. That’s where putting your phone numbers into a number set is helpful. When you send a Campaign using a number set, Ytel handles the distribution of messages across multiple Ytel phone numbers for you.

Also, you can configure and manage callback urls across multiple phone numbers using number sets. So say you have 50 phone numbers that need to hit the same callback url whenever you receive an inbound text or call. You could click each phone number, add the callback url(s), click save, and then move to the next phone number. But this is an extremely laborious process and is susceptible to mistakes. Instead, we recommend that you go to “Manage numbers”, select all the phone numbers that share callback urls, click the “Assign to number set” button, and then add the callback urls the number set. Doing so will automatically apply the callbacks urls to each phone number in the set.

It is important to make sure your callbacks contain the same urls that your number had. For example if you move a contact center number into a number set you will want to copy over the Contact Center urls as well.

Frequently Asked Questions
Q - Can a phone number be in more than one number set?
A - You can only add a number to one number set

Important things to keep in mind while adding funds: 

  • Make sure you have added a card on file prior to going to purchase a number.

  • If you are running into long load times from the dashboard lower the DID you are looking for and see if that helps. 

  • Create a number set prior to the number purchase to save time. 

If you are still having trouble, email support at or you can click the live chat button at the bottom right of your screen. We are available M-F 6am-6pm PST.

Did this answer your question?