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. 

First log into your account. Navigate to and log in using your credentials. If you need to sign up for an account, please click the blue 'Sign up' located at the top right corner of the login page. Make sure you select the end user agreement button as well (we require corporate email for login verification and security purposes, corporate emails are email addresses that include the business name or brand of a company or business).

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. 

Next, use the fields to select the type of number(s) you want to purchase. Specify the number type, the region, area code and the amount of phone numbers to display, then click search.

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 area 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 click the box next to Phone number to select all DIDs, 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 - No, you can only add a number to one number set

Next, we will cover Purchasing Numbers via API

Use our 'Purchase Number' API

(Full docs @

This API will allow you to purchase a list of phone numbers. If using a number set, all the newly purchased numbers will be configured with the settings of the number set.

To fully utilize the 'Purchase Number' API in a programatic fashion, you will first need to run and digest the output of another of our API's.

Use our 'Get Available Numbers' API

(Full docs @

This API will return a list of available numbers to purchase, along with some other additional information. You will want to parse 'Phonenumber: {phonenumber}' from the response and feed into your 'Purchase Number' API request.

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?