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

# Group your phone numbers

> Put several numbers in a group and give the group to a voice agent. The agent answers on every number and calls out from them, and each contact always hears from the same number.

A number group lets one voice agent use many numbers. The agent answers calls on every number in the group and calls out from them. Use it to spread a big campaign over several numbers, or to give one agent a number per region.

## How the agent picks a number

When the agent calls out, Nedzo picks a number from the group for you:

* **A contact the agent already called from the group** hears from that number again, as long as it's still in the group and active.
* **A new contact** gets the number in the group with the fewest calls today.

This works the same for campaigns, the voice call step in workflows, and calls placed through the API. Nedzo skips numbers in the group it can't call out from, like numbers that aren't active.

## 1. Create a group

You need the **Phone Numbers > Manage** permission.

1. Open **Phone Numbers** and select the **Groups** tab.
2. Click **Create group**.
3. Type a **Group name**, like *East coast*, and click **Next**.
4. Tick the numbers that belong in the group. You can search by number or name.
5. Click **Create**.

You can also click **Create** with no numbers ticked and add them later.

If a number you tick already answers or texts as another agent, its row says so, like *Answers as Ava*. Nedzo lists those numbers and the agents they come off. Tick **I understand that these numbers will be unassigned from their agents.** to go on. Only the numbers in that list come off their agents.

## 2. Give the group to an agent

You need the **Agents > Manage** permission. Without it, **Calls use** is greyed out.

1. Open **Agents**, open the voice agent, and go to the **Settings** tab.
2. In the **Call settings** card, set **Calls use** to **Phone number group**.
3. Under **Number group**, pick the group.
4. Click **Save**.

The group's caption on the **Groups** tab now reads **Answers and calls as** and the agent's name.

You can also pick **Create a group** in the **Number group** list. This needs both **Agents > Manage** and **Phone Numbers > Manage**. The new group is picked for the agent, and it goes on the agent when you click **Save**. In that pop-up you can't tick a number another voice agent uses, or this agent's own number. Save the agent with the group first, then add its old number on the **Groups** tab.

## Rules

* **One group per number.** A number already in a group is greyed out and tagged with that group's name. Take it out of that group first.
* **One group per agent, one agent per group.** If you pick a group another agent has, it moves to this agent when you save. The other agent stops answering on its numbers.
* **A caller ID or a group, not both.** An agent can't use a [verified caller ID](https://docs.nedzo.ai/guides/phone-numbers/verify-caller-id.md) and a group at once. Picking one takes the other off when you save.
* **Numbers you bought only.** Verified caller IDs can't join a group.
* **Voice agents only.** Chat and web agents can't hold a group.
* A group holds up to 1,000 numbers. Each group name can be used once in a workspace.

## Change a group

On the **Groups** tab, click **...** on the group's row:

* **Edit numbers:** tick or untick numbers, then click **Save numbers**. A number you untick stops answering as the group's agent and stays in your workspace.
* **Rename:** type the new name and press Enter.
* **Delete:** click **Delete group** to confirm. The group comes off its agent and its numbers stop answering as that agent. The numbers stay in your workspace.

To take a group off an agent without deleting it, set **Number group** to **None** on the agent and click **Save**. The group and its numbers stay, and nobody answers those numbers as an agent until you give the group to one again.

A number in a group always answers as the group's agent. Its own settings panel says so. To change who answers, change the group's agent on the **Agents** page, or take the number out of the group.

## When it doesn't work

* **No Create group button:** you need the **Phone Numbers > Manage** permission. Ask a workspace owner or admin.
* **Pick a group before saving.** You set **Calls use** to **Phone number group** but didn't pick a group.
* **No groups yet. Make one on the Phone Numbers page.** The workspace has no groups, and you can't make one from here. Ask someone with **Phone Numbers > Manage** to create one on the **Groups** tab.
* **A number is tagged Not active:** it stays in the group, but the agent doesn't call out from it.
* **A group named ... already exists.** Pick another name.
* **... texts as another agent.** You ticked a number that a chat agent texts on, from the **Create a group** pop-up on the agent. Add that number on the **Groups** tab instead, where you can confirm it comes off the chat agent.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.