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

# Numbers

> How to buy, link, tag, and manage phone numbers in Fluents.ai.

Numbers are the phone lines your agents use to send and receive calls.\
This page shows you how to **add**, **tag**, and **manage** numbers in the dashboard.

If you’re not yet familiar with how numbers fit into agents and campaigns, start with the\
[Core Concept: Numbers](/product/concepts/numbers).

***

## Video: Numbers

<iframe className="w-full aspect-video rounded-xl" src="https://www.youtube.com/embed/Co6DZJFMJKw" title="Video: Numbers" frameBorder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowFullScreen />

***

## Numbers page overview

Go to **Numbers** in the left sidebar to see all phone numbers available for your account.

You’ll see, for each number:

* **ID** – Internal identifier for the number.
* **Number** – The phone number itself.
* **Agent** – The inbound agent assigned to this number (if any).
* **Telephony Provider** – e.g. Twilio, Telnyx, or a Fluents‑managed provider.
* **Account Connection** – Which provider account this number belongs to.
* **Tags** – Any tags used to group this number.

At the top of the page you can:

* **Configure call pacing** (outbound) to control how often numbers are used.
* **Search numbers** by typing digits into the search bar.
* **Filter by tags** to only see numbers with specific tags.

These tools make it easier to find the right number when assigning agents or configuring campaigns.

***

## Call pacing

Use **Call pacing** to control how frequently your phone numbers are used for **outbound** calling. This helps reduce spam flags and gives you more control over outbound throughput.

### How call pacing works

* **Environment wide setting**\
  Call pacing is configured once on the Numbers page and applies across the environment.

* **Outbound only**\
  Call pacing affects outbound calling (for example, calls placed via [Campaigns](/product/features/campaigns)). It does not apply to inbound calls.

* **Enforced per number (caller ID)**\
  Limits apply to each individual phone number. If one number is temporarily “paced,” other numbers can still be used.

* **Campaign behavior**\
  When pacing limits would be exceeded, Fluents will **delay/schedule** the next outbound call until a number becomes available (instead of failing the call).

### Settings

On the Numbers page, enable **Limit call frequency** (default: **off**) and configure any of the following:

* **Wait X minutes between calls for each number**\
  Adds a minimum delay between outbound call attempts from the same phone number.

* **No more than N calls every H hour(s) for each number**\
  Caps outbound call **attempts** per number using a **rolling window** (for example, “100 calls every 24 hours” is evaluated over the last 24 hours).

> Tip\
> If you need higher total throughput, add more numbers pacing is applied per number, so multiple numbers can share the load.

***

## Prerequisites

Before you add numbers, check:

* **Telephony provider connection**

  To buy or link numbers with your own provider (e.g. Twilio, Telnyx), you must first connect it in\
  **Providers** → see [Providers](/product/features/providers).

* **Plan limits (Fluents‑managed numbers)**

  If you buy numbers using Fluents‑managed credentials, your plan may limit how many numbers you can have.\
  If you click **New** and you’re already at the limit, the modal will show an error instead of adding the number.

There is no Fluents‑side limit when you use your **own** provider accounts.

***

## Buy a new number (New)

Use **New** when you want to buy a fresh number from a provider’s inventory directly inside Fluents.

1. Go to **Numbers**.

2. Click **New** (top‑right).

3. In the **New Number** modal, fill in:
   * **Provider**\
     Choose the telephony provider you want to buy the number from (for example, Twilio).

   * **Account Connection**\
     Select the specific provider account to use.\
     If you don’t see any options, you may need to first connect the provider under **Providers**.

   * **Number**\
     Open the dropdown to see available numbers from that provider.
     * Use the **Search…** field to narrow by digits (for example, type `+1415` to find numbers starting with +1 415).
     * Click the number you want to use.

   * **Inbound Agent** (optional)\
     Select an inbound agent if this number should immediately start receiving calls for that agent.\
     You can also leave this blank and assign an agent later.

   * **Tags** (optional)\
     Start typing to search existing tags or create new ones.\
     Press **Enter** to add each tag (for example, `sales-us`, `after-hours`, `texas`).

4. Click **Add Number**.

If successful, the number appears in the Numbers list and can be used for inbound agents and campaigns.

If you are using Fluents‑managed numbers and have reached your plan limit, you’ll see an error instead of the number being added.

***

## Link an existing number (Link Existing)

Use **Link Existing** when you already own a number with a provider and want Fluents to use it.

Before you start:

* Make sure the provider account is connected in **Providers**.
* Buy or assign the number on your **provider’s website** first (Twilio, Telnyx, etc.).

Then:

1. Go to **Numbers**.

2. Click **Link Existing** (top‑right).

3. In the **New Number** (linking) modal, fill in:
   * **Provider**\
     Choose the provider that owns this number.

   * **Account Connection**\
     Select the specific connected account where the number lives.

   * **Number**\
     Enter the phone number you already own (in full international format, e.g. `+14151234567`),\
     or select it from the provider’s options if your UI shows a dropdown.

   * **Inbound Agent** (optional)\
     Choose the inbound agent that should answer calls to this number, or leave blank for now.

   * **Tags** (optional)\
     Add any tags you’ll use later to group or target this number (for example, `texas`, `clinic-a`).

4. Click **Add Number** (or **Link Number**, depending on your UI).

The number is now visible in Fluents and can be assigned to agents and used in campaigns.\
The number continues to be owned and billed by your telephony provider.

***

## Add or edit tags on a number

Tags help you group numbers for routing and campaigns (for example, “texas”, “sales-us”, “after-hours”).

You can add or change tags:

* **When creating or linking a number**\
  Use the **Tags** field in the **New Number** modal:
  * Start typing to see matching existing tags.
  * Press **Enter** to create a new tag if it doesn’t exist.
  * You can add multiple tags to the same number.

* **For an existing number**
  1. Go to **Numbers**.
  2. On the row of the number you want to change, click the **⋮** menu on the right.
  3. Click **Edit**.
  4. In the **Tags** field:
     * Add tags by typing and pressing **Enter**.
     * Remove tags by clicking the **x** on each tag.
  5. Click **Save** (or the equivalent button).

Tags are free‑form and can be added or removed at any time.\
They’re especially useful when choosing caller IDs for [Campaigns](/product/features/campaigns).

***

## Assign or change the inbound agent for a number

To change which agent answers calls for a number:

1. Go to **Numbers**.
2. On the row of the number you want to update, click the **⋮** menu on the right.
3. Click **Edit**.
4. In the **Inbound Agent** field:
   * Choose the agent that should receive inbound calls to the number, or
   * Clear the value if you don’t want any agent assigned yet.
5. Update tags if needed.
6. Click **Save**.

You can:

* Assign **one number to one agent**.
* Assign **multiple numbers to the same agent** (for example, local numbers in different regions that all route to one agent).

***

## Detach or delete a number

From the **⋮** menu on each number row, you’ll see:

* **Edit** – Change the inbound agent and tags.
* **Detach** – Unlink the number from Fluents.
* **Delete** – Permanently remove the number and release it at the provider.

### Detach a number

Use **Detach** when you want to stop using a number in Fluents,\
but keep it active at your telephony provider.

1. Go to **Numbers**.
2. On the number row, click **⋮** → **Detach**.
3. Confirm the action.

Result:

* The number is removed from your Fluents workspace.
* The number still exists in your provider account, and you can continue to manage or re‑link it later.

### Delete a number

Use **Delete** with care. This permanently removes the number.

1. Go to **Numbers**.
2. On the number row, click **⋮** → **Delete**.
3. Read the confirmation text and confirm.

Result:

* The number is removed from your Fluents.
* Fluents asks the underlying provider to release the number, which typically also stops billing for it.

> **Warning**\
> Deleting a number is permanent and may release it at your telephony provider.\
> Only delete numbers you are sure you no longer need.

If you only want to pause usage in Fluents but keep the number at your provider, prefer **Detach** instead of **Delete**.

***

## Next steps

* Learn how numbers are used in outbound calling in\
  **[Campaigns](/product/features/campaigns)**.
* Revisit the mental model behind numbers in\
  **[Core Concept: Numbers](/product/concepts/numbers)**.
* Connect or manage telephony provider accounts in\
  **[Providers](/product/features/providers)**.