> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squawkvoice.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# Phone Numbers
> Buy phone numbers, assign them to AI agents, and manage number billing
Buy phone numbers directly in the Studio, route inbound calls to your AI agents, and group numbers into [pools](/manage/number-pools) for outbound campaign caller IDs — no external telephony console needed.
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.
Your **first phone number is free**. Each additional number is billed as a Phone Number Add-on — \$1.50/month by default — prorated from the day of purchase.
There is no refund if a number is released mid-cycle. An active plan is required to purchase additional numbers beyond the free one.
## 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
* 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 phone numbers** on the account at the end of the billing cycle — the cancel dialog warns you with the exact count before you confirm.
## Where to go next
Group numbers into rotating caller-ID pools for outbound campaigns.
Put your numbers to work dialing contact lists.