Twilio numbers are added on Telephony → Twilio, not under Phone numbers. The number stays in your Twilio account, Twilio bills you for it, and the platform routes its calls to the agents you choose. You need the Connect Integrations permission to connect the account and Manage Telephony to add numbers.
1. Connect your Twilio account
Open Telephony → Twilio and click Connect Twilio. Enter the Account SID (it starts with AC) and the Auth Token from the Twilio Console. The same connection is shown under Configuration → Integrations, where you can also disconnect it. One Twilio account per workspace.
2. Pick a number and its direction
Under Add a Twilio number, select a Phone number. Only voice-capable numbers that are not yet in use are listed. If the list is empty, buy a number from the Twilio card under Configuration → Integrations. Choose the Direction: Inbound and outbound, Inbound only or Outbound only.
3. Choose the agents
Select the Inbound agent that answers calls to this number and, for outbound use, the Outbound agent that calls from it. Each direction you selected needs its agent; the lists show only agents of that direction. Click Add number. The number is set up on the Twilio side for your agents and then appears in the list below, with no sync step.
4. Change agents later
In the list under the form, use each number's Inbound agent and Outbound agent selectors. Changes save straight away and the number is re-registered with the direction its agents imply. Choose No inbound agent or No outbound agent to stop using it in that direction.
5. Add from the phone-number form instead
Phone numbers → Add phone number also accepts Twilio numbers: choose Twilio — your Twilio numbers in the SIP trunk list, pick the number, and use the Inbound calls and Caller ID (outbound) switches as the direction. An Outbound agent field appears when Caller ID (outbound) is on. Both routes save the same number.
A number that is already imported into a Vapi or Retell agent is refused with the message that it is set up for that agent; remove it there first. To give a number up, use Release to Twilio on the Integrations card, which deletes it from your Twilio account and stops its rental charge.