***

title: Phone Numbers
sidebarTitle: Phone Numbers
description: Get and manage phone numbers for your agents.
----------------------------------------------------------

Phone Numbers let your agents make and receive real phone calls. Rent numbers directly through Atoms, or import your own via SIP.

***

## Your Numbers

<Frame>
  <img src="https://files.buildwithfern.com/smallest-ai.docs.buildwithfern.com/a259080494c4fbb2d952acdec084f2eff6daf4efae539d6af0de0a8834543883/products/atoms/pages/platform/building-agents/images/phone-numbers.png" alt="Phone Numbers page" />
</Frame>

The main view shows all your phone numbers with key details:

| Field               | Description                      |
| ------------------- | -------------------------------- |
| **Number**          | The phone number                 |
| **Provider**        | Telephony provider (e.g., Plivo) |
| **Connected Agent** | Which agent is assigned          |
| **Agent Name**      | Name of the connected agent      |
| **Rent Date**       | When you acquired the number     |
| **Monthly Cost**    | Recurring cost                   |
| **Status**          | Active or inactive               |

Click any number in the list to see its details and manage it.

***

## Adding a Number

Click **Add Number** in the top right. You have two options:

<Tabs>
  <Tab title="Rent Number">
    <Frame caption="Rent Number modal">
      ![Rent number](https://files.buildwithfern.com/smallest-ai.docs.buildwithfern.com/4f21da01e980c894aef224eb949078e3040c22605f7a103602c73a8df60f3ca5/products/atoms/pages/platform/building-agents/images/rent-number.png)
    </Frame>

    Rent a new phone number directly through Atoms.

    1. Click **Add Number** → **Rent Number**
    2. Select your country and preferences
    3. Choose from available numbers
    4. Complete the rental

    The number appears in your list immediately, ready to assign to an agent.
  </Tab>

  <Tab title="Import SIP">
    <Frame caption="Import SIP Number modal">
      ![Import SIP number](https://files.buildwithfern.com/smallest-ai.docs.buildwithfern.com/8efb816144f21866617012a21cd6a5b16ac389e5700b2a997f4d98ecbb6f34fa/products/atoms/pages/platform/building-agents/images/import-sip.png)
    </Frame>

    Bring your own number via SIP trunking.

    | Field                   | Required | Description                                    |
    | ----------------------- | -------- | ---------------------------------------------- |
    | **Phone Number**        | Yes      | Your existing number                           |
    | **SIP Termination URL** | Yes      | Where to send calls                            |
    | **Display Name**        | No       | Friendly name for the number                   |
    | **Username**            | No       | For SIP authentication                         |
    | **Password**            | No       | For SIP authentication                         |
    | **SIP Origination URL** | —        | Provided by Atoms (copy this to your provider) |

    Click **Add Custom Number** when done.
  </Tab>
</Tabs>

***

## Assigning to an Agent

Once you have a number, assign it to an agent:

1. Open your agent
2. Go to **Agent Settings** → **Phone Number** tab
3. Select the number from the dropdown
4. Save

Now calls to that number will be handled by your agent.

***

## Releasing a Number

To stop using a number, click it in the list and click **Release**.

<Warning>
  Releasing a number expires it at the end of the month and **cannot be undone**. The number cannot be reused.
</Warning>

***

## Related

<CardGroup cols={2}>
  <Card title="Audiences" icon="users" href="/atoms/atoms-platform/deployment/audiences">
    Manage contact lists for campaigns
  </Card>

  <Card title="Campaigns" icon="bullhorn" href="/atoms/atoms-platform/deployment/campaigns">
    Use numbers for outbound calling
  </Card>
</CardGroup>