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

# Manage Numbers

> Buy, connect, assign, and remove phone numbers in Ringg AI.

Numbers are the phone lines your assistants use to make and receive calls. You can use Ringg AI numbers or connect numbers from your own telephony provider.

***

## View Numbers

1. Click **Numbers** in the left sidebar.
2. Review the numbers in your workspace.

Each row shows:

| Field            | Meaning                                 |
| ---------------- | --------------------------------------- |
| **Phone number** | The full caller number                  |
| **Country**      | The number's country                    |
| **Date added**   | When the number was added               |
| **Used By**      | Which assistant or campaign is using it |
| **Tags**         | Labels such as `Default Number`         |

***

## Buy a New Number

1. On the **Numbers** page, click **Buy new number**.
2. Choose the country, area, and number type if those options are available.
3. Review the purchase details.
4. Confirm the purchase.

The number appears in your workspace after the purchase completes.

<Note>
  Number availability and pricing depend on the country and telephony provider.
</Note>

***

## Bring Your Own Telephony

Use **Bring Your Own Telephony** when your company already owns numbers with a provider such as Twilio, Exotel, or Plivo.

1. Click **Integrations** in the left sidebar.
2. Open the **Your Telephony** tab.
3. Click **Add New**.
4. Choose the provider.
5. Enter the provider credentials.
6. Click **Save**.
7. Return to **Numbers** and confirm the numbers appear.

The **Telephony** dropdown at the top of the Numbers page shows the active provider.

***

## Set a Default Number

A number tagged as **Default Number** is used when no specific number is selected.

1. Find the number on the **Numbers** page.
2. Click the tag action.
3. Add the tag `Default Number`.
4. Save the change.

Use one default number per workspace unless your operations team has a specific routing plan.

***

## Assign Numbers to Campaigns

You choose caller numbers while creating a campaign.

1. Open or create the campaign.
2. In the **Numbers** field, select one or more numbers.
3. Save the campaign.

Multiple numbers can spread call volume across caller IDs.

For **Inbound** assistants, the assigned number is the number customers dial.

***

## Remove a Number

1. Confirm the number is not used by a live campaign or inbound assistant.
2. Click **Remove** next to the number.
3. Confirm the removal.

<Warning>
  Removing a number that is used by a running campaign or inbound assistant can interrupt calls. Pause campaigns or reassign assistants before removing it.
</Warning>

***

## Developer Handoff

If engineers will make API calls or configure routing, send them:

| Item                           | Why They Need It                                                                |
| ------------------------------ | ------------------------------------------------------------------------------- |
| Phone number                   | Helps confirm the visible caller ID                                             |
| Number provider                | Tells them whether the number is Ringg AI-owned or from your telephony provider |
| `from_number_id`               | Preferred identifier for outbound API calls when available                      |
| `from_number`                  | Use only when the API flow expects the literal phone number                     |
| Assigned assistant or campaign | Helps them confirm the number is used in the right place                        |

For individual outbound API calls, exactly one caller-number option is required: `from_number_id` or `from_number`. Do not send both.