- Open your project in Agent Studio and go to Integrations.
- Open the Telephony tab and click Add number.
- In the Add a number panel, under Transfer or buy a number, choose a Twilio option.
If an option shows Coming soon, contact your PolyAI account manager. To send SMS from a Twilio number, see SMS.
- Buy Twilio number
- Connect Twilio account
PolyAI buys the number, manages it, and routes it to your agent. Calls reach the agent as soon as the number is bought. Usage is billed through PolyAI at the rate in your contract.
Buy a number
1
Open the buy panel
In the Add a number panel, click Buy Twilio number.
2
Choose a country
Pick a Country: United Kingdom, United States, Canada, Australia, Ireland, Spain or Denmark.Every country except the United States and Canada needs regulatory approval before you can buy. See Regulatory approval below.
3
(Optional) Enter an area code
For United States and Canada, an Area code field appears. Enter three digits, such as
415.PolyAI only searches the area code you enter. It does not fall back to a nearby one. If that area code is sold out, the purchase fails. Leave the field blank to take any available number in the country.4
Choose an environment
Pick the Environment that should answer calls on this number. This field is required.
5
(Optional) Choose a variant
If your agent has variants, a Variant field appears. Pick one to send calls on this number to that variant. Leave it as Default (no variant) to use the default agent.
6
Buy the number
Click Buy number. When the purchase finishes, the panel closes and the number appears in the Telephony table with its environment and variant. Calls to it go straight to your agent.If the purchase fails, Agent Studio shows Couldn’t buy the number with the reason. Try again, or try without an area code.
Regulatory approval
Local regulations require an approved regulatory bundle before you can buy a number in the United Kingdom, Australia, Ireland, Spain or Denmark. A bundle is the business details and documents the country’s regulator asks for. Until yours is approved, a warning appears after you choose the country, and Buy number stays disabled.A bundle covers every project in your account, so you only submit it once per country. If a bundle is rejected, Submit regulatory bundle starts a new submission.
If your account is on a trial that can’t go live yet, the panel shows an upgrade prompt instead of the form.
Delete a bought number
- In the Telephony table, open the actions menu on the number.
- Click Delete number and confirm.
Related pages
- Manage numbers: change a number’s environment or variant, or delete it
- Forward your existing number: keep the number callers know
- SMS: send text messages from a Twilio number
- Handoffs: configure transfer destinations
- Environments: how Sandbox, Pre-release and Live receive calls
- Telephony: every way to connect a number

