Docs
Open dashboard
Telephony

Use your Twilio numbers

Connect your Twilio account and give its numbers to your agents. No SIP trunk is needed.

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. 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. 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. 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. 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. 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.

Go to workspace