Phone Numbers

Buy phone numbers directly in the Studio — or bring numbers you already own — then route inbound calls to your AI agents and group numbers into pools for outbound campaign caller IDs. Phone numbers live in Studio → Manage → Phone Numbers.

​

Buying a Number

1. Click Buy Number. The Buy a Phone Number drawer opens.
2. Select a Country — United States, Canada, or Australia — and optionally an Area Code (e.g. 415).
3. Click Search and pick from the available numbers. Each result shows its locality and Voice/SMS capabilities.
4. Click Purchase. For billable numbers a Confirm purchase dialog shows the exact prorated charge for the current month and the recurring monthly amount before you commit.

​

How Number Search Matches

The Area Code box is a pattern, and the results only include numbers that genuinely match it — a search for 415 returns numbers in that area code, not numbers that happen to contain those digits somewhere further along. For US and Canadian numbers the pattern is matched against the 10-digit national number. Behaviour worth knowing: because matching is strict, a pattern that used to bring back a long list may now return fewer numbers, or none at all. When nothing matches, you see an empty state rather than an unrelated list — try fewer digits, or a different area code. This is one shared search, used everywhere numbers are bought: the call-routing step during onboarding, Studio → Manage → Phone Numbers, and buying a number inline while building a number pool.

​

Adding a Number You Already Own

If you already hold numbers with your own carrier, you can add them to the workspace instead of buying new ones. Once added they behave like any other number in the list — assign them to an agent, add them to pools, release them.

1. Click BYO Number. The drawer opens on Single number.
2. Enter the number in international format, for example +14155550100, and click Add BYO Number.

To add several at once, switch to Range of numbers:

1. Enter the Start number.
2. Choose a Count — 5, 10, 25, 50, or 100, or click Custom to enter any value from 2 to 100.
3. Click Add BYO Numbers. The platform walks upward from the start number; any number already in use is skipped and reported back under Skipped (already in use), so a partly-used range still succeeds.

BYO numbers show a BYO badge in the numbers list in place of the Free/Billable badge.

​

Assigning a Number to an AI Agent

Assigning a number routes its inbound calls to an agent:

1. Click Assign on an unassigned number (or Reassign on an assigned one).
2. Search and select the AI agent in the Assign Phone Number drawer.

A number can be active on only one agent at a time; an agent can hold many numbers. Inbound call routing is updated automatically the moment the assignment saves. Unassign stops routing new calls to the agent — active calls are not interrupted, but new calls go unrouted until the number is assigned again.

​

Releasing a Number

Click the Release number action and confirm. Releasing permanently removes the number — it cannot be undone, and no refund is issued for the remainder of the billing cycle. A number cannot be released while it is:

• Assigned to an agent — unassign it first (the dialog offers a shortcut).
• In an active number pool — remove it from all pools first; the dialog lists the pools that block release.

​

Number Billing

Billing applies only to numbers purchased in the Studio. Numbers you bring yourself are never charged, do not use up your free included number, and are not counted on the plan card.

• The billing overview plan card shows a live summary line, e.g. “3 phone numbers — 1 included, 2 × $1.50 =$3.00/mo”.
• If a number’s monthly invoice payment fails, the number is badged Payment Failed. It keeps working, and returns to normal automatically once the invoice is paid.
• Cancelling your subscription permanently removes all purchased phone numbers on the account at the end of the billing cycle — the cancel dialog warns you with the exact count before you confirm. BYO numbers are yours and are left in place.

​

Where to go next