Skip to main content

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.

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.
Managing many numbers? The Agents API exposes bulk import, get, and reassign operations.

​
Purchase a number

1

Open the Numbers page

Go to Configure > Numbers in the sidebar.
2

Add a number

Click Add Number.
3

Select a region

Choose US or UK depending on where your callers are located.
4

Confirm

Click Add Number. The number provisions in seconds and is ready for use.
Once provisioned, you can assign the number to a specific environment (Sandbox, Pre-release, or Live) to control which version of your agent receives calls.
Use separate numbers for each environment to avoid accidentally routing test calls to production.

​
Next steps

Assign numbers to environments

Deploy numbers across Sandbox, Pre-release, and Live environments

Connect a Twilio number

Use existing Twilio numbers instead of purchasing new ones

Set up outbound calling

Configure proactive outbound calls for reminders and follow-ups

Phone number management

Add, delete, and assign numbers across environments
Last modified on April 22, 2026