> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bizzyco.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Buying a Phone Number

> Search available numbers from Telnyx and purchase through Bizzy

Bizzy sells phone numbers through Telnyx. Checkout runs through Stripe — the
line item appears on your Bizzy invoice, not a separate Telnyx one.

## Three entry points

### From the phone numbers inventory

1. Go to **Phone Numbers** in the sidebar.
2. Click **Buy number**.
3. You land on `/{org}/phone-numbers/buy`, the search page.

### From the purchases page

1. Go to **Purchases** in the sidebar.
2. Click **Purchase Phone Numbers** (or the **Phone Numbers** quick action).
3. You land on the same search page.

### From the inbox setup wizard

If you're still setting up, the **Inbox Setup Wizard** at `/{org}/inbox/setup`
lets you choose "Phone" and walks through location → search → select → checkout
→ success.

## The purchase flow

1. **Choose a location** — pick a country (default: United States) and
   optionally an area code.

2. **Refine your search** (optional) — narrow the results with any of these
   filters:

   * **Pattern** — a digit or vanity string up to 7 characters (e.g. `1000`,
     `COURIER`). Letters are mapped to phone-keypad digits before searching, so
     `COURIER` matches numbers containing `2687437`.
   * **Type** — restrict to **Local**, **Toll-free**, or **Mobile**, or leave
     as **Any**.
   * **Capabilities** — tick **Voice**, **SMS**, or **MMS** to require those
     features on the returned numbers. Voice and SMS are pre-selected;
     unchecking everything returns numbers regardless of capability.

   All filters live in the URL, so a search like
   `/{org}/phone-numbers/buy?countryCode=US&areaCode=415&pattern=1000&phoneNumberType=local&features=voice,sms`
   is shareable and bookmarkable.

3. **Pick a number** — Bizzy queries Telnyx and lists available numbers with
   their features and monthly cost. Click the one you want.

4. **Review** — confirm the selection and the calculated total on the purchase
   confirmation page.

5. **Checkout** — you're redirected to Stripe to pay.

6. **Success** — you land back on Bizzy's success page, and the number attaches
   to your organization automatically. The `phone_number_provision` metric is
   emitted for billing.

## Adding a number you already own

If you already have a Telnyx number and want to attach it directly:

1. Go to **Phone Numbers**.
2. Click **Add existing number** to open the inline form (or visit
   `/{org}/phone-numbers/new` for the full-page version).
3. Fill in:
   * **Name** — a label you'll recognize
   * **Phone number** — in E.164 format (for example `+14155550123`)
   * **Country code** and **Region**
   * **Provider** — Telnyx
4. Save.

The number is now available for configuration.

## Troubleshooting

| Problem                                  | Likely cause                                            | Fix                                                                                                                |
| ---------------------------------------- | ------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| No available numbers in search           | Filters too narrow, or area code out of stock at Telnyx | Loosen the pattern, switch type to **Any**, untick capabilities you don't strictly need, or try a nearby area code |
| Vanity pattern returns nothing           | The mapped digits don't exist in stock                  | Shorten the pattern (try 3–4 chars), or change the area code                                                       |
| Stripe checkout fails                    | Payment method issue                                    | Update in [Billing](/admin-guide/billing/index)                                                                    |
| Purchase succeeded but number not listed | Webhook lag                                             | Wait 30–60 seconds and refresh                                                                                     |

## Next steps

<CardGroup cols={2}>
  <Card title="Configuring a phone number" icon="gear" href="/user-guide/phone-numbers/configuring">
    Turn on SMS, voice, voicemail, recording
  </Card>

  <Card title="Purchases" icon="receipt" href="/user-guide/purchases/index">
    See your purchase history
  </Card>
</CardGroup>