Where to buy
Phone numbers live at Settings → Connections → Phone numbers. They are not under a brand: a number is bought by the organization, has its own line on your invoice, and can only ever ring one voice agent — so it cannot be shared between brands.
The page is one list of your numbers. The New phone number button under it (Get a phone number while the list is still empty) opens the dialog where you search for and buy a number. Orders that are still waiting on paperwork show up in the same list.
Only the organization owner can buy a number. An administrator opening this page will be refused at the purchase step, because buying charges the card on file. If you are not the owner, ask them to do this part.
Pick a country and a number type
In the New phone number dialog, choose a country first — the list is whatever Telnyx, our telephony provider, currently sells. Then pick a number type, or leave it on Any type:
| Type | What it is |
|---|---|
| Local | A geographic number tied to a specific city or region. |
| Mobile | A mobile number, typically used for SMS and voice. |
| National | A non-geographic number reachable from anywhere in the country. |
| Toll-free | Free for the caller — your organization pays for incoming calls. |
| Shared cost | The cost is split between the caller and your organization. |
Narrow the search
Type the first digits you want into the Phone number field to find numbers that start with them. If the first page of results is not what you want, open Advanced filters. You can filter by area code, city, state or region, and by numbers that contain or end with particular digits. Two switches are worth knowing:
- Include approximate matches — widens the search to numbers that roughly fit your filters, useful when an exact pattern returns nothing.
- Instant activation only — shows only numbers that can take calls immediately with no verification wait. It applies to US and Canadian toll-free numbers.
Each result shows its monthly rental on the card. Click one and the summary on the right adds the setup fee and what the number supports — voice is the one that matters for a voice agent.
Check what you are paying
Clicking a number fills the summary on the right with what you pay, and it separates the two things clearly:
- Total due now — the one-time setup fee, plus the rental prorated for the days left until your next billing date. The dialog shows how many days that is.
- Billed monthly — the recurring rental, and the date it starts.
The summary also asks which voice agent should answer the number. You have to choose one before you can buy, so create a voice agent first if you have none yet; you can change it later. The button names the amount, so you are clicking "Pay $9.42 & activate" rather than a bare "Confirm".
Confirm — and what happens if it fails
Your card is charged immediately. When the purchase goes through, the dialog switches to a confirmation, Say hello to your new number!, showing the number and the agent that answers it. The number is live and calls to it are answered right away. Click Done to close the dialog; the number is now in the list on the Phone numbers page.
If the purchase does not go through, the dialog stays on the buying screen and shows a red panel headed "The purchase did not go through" with the provider's reason. The confirmation only appears after a successful purchase — so if you saw it, it worked. Read the reason before trying again; buying a second time when the first one actually succeeded is the expensive mistake here.
If the country needs paperwork
Some countries require proof of address, an end-user declaration or a local tax number before a number can be switched on. When that happens the purchase becomes an order rather than an instant activation, and you are told so: the dialog says Your number is reserved, and a message says "Verification is required before activation." Click Continue verification to open the window that lists everything still outstanding.
You can also pick it up later from the same list on the Phone numbers page: the order shows as a New order row with the status Verification required, and its Continue button opens the same window. Upload what is asked for, and the number activates once the carrier approves it — usually within 1–3 business days.
You do not have to chase a pending order. A number that has finished activating shows up in the list within an hour at worst, and opening the Phone numbers page checks right away.
Have your documents ready as clear, legible PDFs before you start. Most verification delays come from blurry scans, the wrong country of issue, or an expired ID — not from the carrier being slow.
What the numbers list shows
One row per number, with its name (the nickname you gave it), its country, its type, the number itself, the agent that answers it, its monthly cost and its status. There is no brand column — a number belongs to the organization, and it reaches a brand only through the agent you point it at.
Assign the number to an agent
Two places do the same job:
- From this page, edit the number's row (the pencil icon, or Edit in its ⋯ menu) and pick the voice agent that should answer it — you can give the number a nickname there too.
- Or open the agent at Brand → AI agent → Phone, go to its Phone numbers section, and choose the number there.
A number rings exactly one agent. Assigning it to a second agent takes it away from the first. There is nothing else to link: the agent answers from its brand.
How a number stops costing money
This is the part that catches people out, so read it before you buy a second number. Releasing the number on this page is the only thing that stops the monthly charge. In particular:
- Deleting the voice agent un-assigns its numbers and resets their routing — but the numbers stay in your account and keep billing.
- Deleting the whole brand deletes its voice agents and never touches its numbers. They stay on the organization, unassigned, still billing.
- Pausing an agent stops it answering, but the rental continues.
Releasing stops the recurring charge at once and credits the unused part of the current month to your account balance; the one-time setup fee is not refunded. It is also owner-only, and it can fail: if the carrier refuses to take the number back you get "The number could not be released with our phone provider, so nothing has been removed. Please try again, or contact support if it keeps happening." Retrying is safe and is the right thing to do — but be aware that at that moment the recurring charge has already been stopped and any prorated credit already applied, while the number is still shown in your list.
Next step
For the full money picture, read Phone number setup fees and monthly rental. To give the number something to answer with, read Create a voice agent.