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

# Buy a number from PolyAI

> Purchase phone numbers directly in Agent Studio.

You can purchase a phone number directly from PolyAI without needing a third-party telephony provider like Twilio. PolyAI-provisioned numbers are preconfigured to route calls to your agent immediately.

<Info>
  Managing many numbers? The [Agents API](/api-reference/agents/introduction) exposes bulk [import](/api-reference/agents/endpoint/phone-numbers/import-phone-numbers-into-a-project), [get](/api-reference/agents/endpoint/phone-numbers/batch-get-phone-numbers), and [reassign](/api-reference/agents/endpoint/phone-numbers/reassign-a-phone-number-to-a-different-connector) operations.
</Info>

## Purchase a number

<Steps>
  <Step title="Open the Numbers page">
    Go to **Voice > Numbers** in the sidebar.
  </Step>

  <Step title="Add a number">
    Click **Add Number**.
  </Step>

  <Step title="Select a region">
    Choose **US**, **UK**, or **Canada** depending on where your callers are located.
  </Step>

  <Step title="[Optional] Pick an area code">
    For **US** and **Canada** numbers, you can optionally specify a **3-digit area code** to source the number from a specific region (for example, `415` for San Francisco or `416` for Toronto). Leave the field empty to let PolyAI auto-assign one from the available pool.

    Both countries share the North American Numbering Plan (NANP), so area code selection works identically.
  </Step>

  <Step title="Confirm">
    Click **Add Number**. The number provisions in seconds and is ready for use.
  </Step>
</Steps>

Once provisioned, you can assign the number to a specific [environment](/environments-and-versions/introduction) (Sandbox, Pre-release, or Live) to control which version of your agent receives calls.

<Tip>Use separate numbers for each environment to avoid accidentally routing test calls to production.</Tip>

## Next steps

<CardGroup cols={2}>
  <Card title="Assign numbers to environments" icon="layer-group" href="/environments-and-versions/introduction">
    Deploy numbers across Sandbox, Pre-release, and Live environments
  </Card>

  <Card title="Connect a Twilio number" icon="phone" href="/voice-channel/numbers/twilio/how-to-integrate-voice">
    Use existing Twilio numbers instead of purchasing new ones
  </Card>

  <Card title="Set up outbound calling" icon="phone-arrow-up-right" href="/voice-channel/numbers/outbound-calling">
    Configure proactive outbound calls for reminders and follow-ups
  </Card>

  <Card title="Phone number management" icon="list" href="/voice-channel/numbers/route-management">
    Add, delete, and assign numbers across environments
  </Card>
</CardGroup>