Phone Numbers

Learn how to create and configure phone numbers with Vapi.

Set up a Phone Number

You can set up a phone number to place and receive phone calls. Phone numbers can be bought directly through Vapi, or you can use your own from Twilio.

You can buy a phone number through the dashboard or use the /phone-numbers/buy` endpoint.

If you want to use your own phone number, you can also use the dashboard or the /phone-numbers/import endpoint. This will use your Twilio credentials to verify the number and configure it with Vapi services.

Outbound Calls

You can place an outbound call from one of your phone numbers using the /call/phone endpoint. If the system message will be different with every call, you can specify a temporary assistant in the assistant field. If you want to reuse an assistant, you can specify its ID in the assistantId field.

Inbound Calls

You can provide an assistantId to a phone number and it will use that assistant when receiving inbound calls.

You may want to specify the assistant based on the caller’s phone number. If a phone number doesn’t have an assistantId, Vapi will attempt to retrieve the assistant from your server using your Server URL.