Skip to navigation
Phone Numbers

Create Phone Number

Creates a Vapi phone number or imports a phone number from a supported provider, including Twilio, Vonage, Telnyx, or a bring-your-own provider.

Authentication

AuthorizationBearer

Authenticate server-side requests with a private Vapi API key. Create or copy a key from the Vapi Dashboard and send it in the Authorization header as Bearer <token>. Keep private API keys out of client-side code and public repositories.

Request

This endpoint expects an object.
byo-phone-numberobjectRequired

Configuration used to connect a bring-your-own phone number to Vapi with a stored telephony credential and routing settings.

OR
twilioobjectRequired
Configuration used to import a Twilio phone number into Vapi with its account credentials and routing settings.
OR
vonageobjectRequired
Configuration used to import a Vonage phone number into Vapi with a stored credential and routing settings.
OR
vapiobjectRequired

Configuration used to provision a Vapi-managed phone number or connect a SIP URI, with optional routing and authentication settings.

OR
telnyxobjectRequired
Configuration used to import a Telnyx phone number into Vapi with a stored credential and routing settings.

Response

byo-phone-numberobject

A phone number connected to Vapi through a bring-your-own telephony provider, including its credential, routing, hooks, server settings, and lifecycle metadata.

OR
twilioobject
A Twilio phone number connected to Vapi, including its Twilio account details, SMS configuration, routing, hooks, server settings, and lifecycle metadata.
OR
vonageobject
A Vonage phone number connected to Vapi, including its credential, routing, hooks, server settings, and lifecycle metadata.
OR
vapiobject

A Vapi-managed phone number or SIP URI, including its authentication, routing, hooks, server settings, and lifecycle metadata.

OR
telnyxobject
A Telnyx phone number connected to Vapi, including its credential, routing, hooks, server settings, and lifecycle metadata.