# Purchase phone number

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 [Custom Telephony guide](https://docs.retellai.com/deploy/custom-telephony).

#### [​](https://docs.retellai.com/deploy/purchase-number#from-dashboard)From Dashboard <a href="#from-dashboard" id="from-dashboard"></a>

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

![](https://mintlify.s3.us-west-1.amazonaws.com/retellai/images/deploy/purchase-number/purchase.jpeg)![](https://mintlify.s3.us-west-1.amazonaws.com/retellai/images/deploy/purchase-number/purchase-popup.jpeg)

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

![](https://mintlify.s3.us-west-1.amazonaws.com/retellai/images/deploy/purchase-number/rename.jpeg)

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!

#### [​](https://docs.retellai.com/deploy/purchase-number#from-api)From API <a href="#from-api" id="from-api"></a>

Check out [Create Phone Number API Reference](https://docs.retellai.com/api-references/create-phone-number) for all the parameters you can use programmatically.

* Phone numbers are yours once purchased, and can be used indefinitely. Find numbers you own [here](https://docs.retellai.com/api-references/list-phone-numbers).
* 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

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

#### [​](https://docs.retellai.com/deploy/purchase-number#pricing)Pricing <a href="#pricing" id="pricing"></a>

Numbers are charged at $2 per month.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://project-44.gitbook.io/retell-ai/deploy/purchase-phone-number.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
