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

# Phone numbers

> Buy or import a phone number and connect it to an agent.

Phone numbers connect published agents to inbound and outbound calls.

<Frame caption="The Phone Numbers workspace combines numbers, provider connections, pools, assignments, and health warnings.">
  <img src="https://mintcdn.com/persistence-ai/vTPO-R7syJyo2N_1/images/dashboard/phone-numbers.png?fit=max&auto=format&n=vTPO-R7syJyo2N_1&q=85&s=c2a7c66dc54a02d82d4f274b25a76559" alt="Persistence Phone Numbers dashboard with inventory, connections, pools, and agent routing" width="640" height="360" data-path="images/dashboard/phone-numbers.png" />
</Frame>

## Add a number

Open **Numbers** and select **Add number**. Choose the path that matches your phone setup:

<CardGroup cols={3}>
  <Card title="Buy new number" icon="shopping-cart">
    Search available inventory and buy a number for the workspace.
  </Card>

  <Card title="Import from provider" icon="cloud-download">
    Import numbers from a connected Twilio or Telnyx account.
  </Card>

  <Card title="Add manually" icon="network">
    Add a custom phone number and SIP configuration.
  </Card>
</CardGroup>

## Configure routing

Open a number to assign its inbound and outbound agents. Publish the agent version you want to use before routing live calls to it.

You can also configure supported controls for the number, including:

* Allowed inbound countries
* Allowed outbound countries
* SIP settings for a manually connected number
* An inbound webhook for events that need to reach your application

For custom SIP, configure the outbound termination URL, optional credentials, transport, and inbound trunk information supplied by your provider. Test the inbound webhook before saving it.

<Warning>
  Verify the selected agent, phone number, and country restrictions before you enable production traffic.
</Warning>

## Remove a number

Unassign agents and confirm that no active workflow depends on the number before you remove it. Removing a number can stop inbound or outbound calls that use it.

You can deactivate a number temporarily and activate it again later. A deactivated number is unavailable for calls.