Purchase phone number

This guide will walk through how to purchase a number from Retell. The numbers are managed by Retell, so you don’t have to worry about the telephony infrastructure.

​

From Dashboard

You can purchase and bind agents to the number from the dashboard. You can optionally specify the area codes you want to purchase from.

After the number is purchased, you can change its nickname so that it’s easier for you to find and identify.

At this stage, the number should already be ready to accept inbound calls if you have assigned an inbound agent. Give it a try by calling it!

​

From API

Check out Create Phone Number API Reference for all the parameters you can use programmatically.

• Phone numbers are yours once purchased, and can be used indefinitely. Find numbers you own here.
• You can assign different inbound and outbound agent to the number.
• If you don’t want user to be able to call this number (maybe you are doing outbound and don’t want callbacks), you can leave inbound_agent_id unset.

const phoneNumberResponse = await retell.phoneNumber.create({
  inbound_agent_id: "oBeDLoLOeuAbiuaMFXRtDOLriTJ5tSxD", // replace with the agent id you want to assign
  outbound_agent_id: "oBeDLoLOeuAbiuaMFXRtDOLriTJ5tSxD", // replace with the agent id you want to assign
});

console.log(phoneNumberResponse);

​

Pricing

Numbers are charged at $2 per month.