Purchase a Retell-managed US or Canada phone number

Purchase a phone number from Retell directly in the dashboard or through the API. Retell manages these numbers, so you don’t have to set up any telephony infrastructure.

Currently we only support purchase of US and Canada numbers and support making calls to 15 countries. If you are looking to use numbers from other countries, or to make calls to more countries, or to use your own telephony provider, check out Custom Telephony guide.

You must add a payment method to your workspace before you can purchase a phone number.

From the dashboard

Open the Phone Numbers page in the dashboard sidebar and click + to purchase a number and bind agents to it. You can optionally specify the area codes you want to purchase from.

After purchasing, you can change the number’s nickname to make it easier to find and identify.

The number is ready to accept inbound calls once you’ve assigned an inbound agent. Try calling it.

From the 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 agents to the number.
If you don’t want a user to be able to call this number (maybe you are doing outbound calls and don’t want callbacks), you can leave inbound_agent_id unset.
To purchase a US toll-free number, set toll_free to true. Toll-free numbers cost more than regular numbers. See Pricing.

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);

# Purchase a phone number
phone_number = client.phone_number.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
)
print(phone_number)

Pricing

We support both Twilio and Telnyx numbers:

Twilio
- US numbers: $2/month
- US toll-free numbers: $5/month
- Canadian numbers: $2/month
Telnyx
- US numbers only: $2/month

Toll-free numbers cost $0.06 per minute for inbound calls. Outbound calls are charged at the same rate as regular U.S. numbers.

The monthly number fee is billed to your payment method at the end of each billing cycle (prorated if purchased mid-month on credit-based accounts) and recurs until the number is released. See the billing overview for how number charges appear on your invoice.

FAQ

Can I use a phone number I already own?

Yes. Connect your own telephony provider through custom telephony, or import an existing number into Retell.

Can I buy a number outside the US and Canada?

Not directly. Retell-managed numbers are US and Canada only. To use numbers from other countries, connect your own provider via custom telephony. Retell-managed numbers can still place calls to 15 countries.

How do I release a number I no longer need?

Delete it from the phone number page in the dashboard, or call the Delete Phone Number API. The monthly fee stops once the number is released.

Conductor (AI Assistant)

Build

Test

Deploy

Data

Monitor

Reliability & Debugging

Accounts and Workspace

Integrations

Marketplace

Other Topics

Purchase phone number

From the dashboard

From the API

Pricing

FAQ

​From the dashboard

​From the API

​Pricing

​FAQ

From the dashboard

From the API

Pricing

FAQ