Managing many numbers? The Agents API exposes bulk import, get, and reassign operations.
Purchase a number
1
Open the Numbers page
Go to Voice > Numbers in the sidebar.
2
Add a number
Click Add Number.
3
Select a region
Choose US, UK, or Canada depending on where your callers are located.
4
[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.5
Confirm
Click Add Number. The number provisions in seconds and is ready for use.
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

