Retell AI
  • Get Started
    • Build your first phone agent in 5 minutes
    • SDKs
  • Build
    • Overview
    • Handle background noise
    • Handle voicemail
  • Test
    • Best Practices
    • LLM Playground
    • Web Call
  • Deploy
    • Purchase phone number
    • Overview
    • Make & receive phone calls
    • Connect to web call
    • Understand concurrency & limits
Powered by GitBook
On this page
Export as PDF
  1. Deploy

Purchase phone number

PreviousWeb CallNextOverview

Last updated 4 months ago

A step by step guide to buy a number from Retell

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.

Currently we only support purchase of US numbers and only support making domestic calls from the platform. If you are looking to use numbers from other countries, or to make international calls, or to use your own telephony provider, check out .

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 for all the parameters you can use programmatically.

  • Phone numbers are yours once purchased, and can be used indefinitely. Find numbers you own .

  • 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.

NodePython

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

Numbers are charged at $2 per month.

Pricing

​
Custom Telephony guide
​
​
Create Phone Number API Reference
here