Register Phone Number
Register a phone number for an agent.
Two modes of operation:
-
LiveKit Phone Numbers (provider=‘livekit’):
- For numbers already purchased through LiveKit Cloud dashboard
- No SIP trunk configuration needed
- Simplified setup - just provide the phone number
- LiveKit automatically manages the infrastructure
-
External SIP Providers (twilio, vonage, telnyx, etc.):
- You must already own the phone number
- Creates SIP dispatch rule in LiveKit
- Returns SIP URI to configure in provider’s dashboard
- Supports both inbound and outbound calling
Authorizations
Body
Request to register a phone number for an agent.
Provide phone number and trunk details - LiveKit handles the SIP infrastructure.
For LiveKit phone numbers (provider='livekit'):
- Purchase your number through LiveKit Cloud dashboard first
- No trunk configuration needed - LiveKit manages the infrastructure
- Just provide the phone number and it will be configured automatically
For external providers (twilio, vonage, etc.):
- You must own the number already
- SIP trunk configuration is required
- You'll receive a SIP URI to configure in provider's dashboard
IMPORTANT FOR VONAGE USERS: Vonage Elastic SIP Trunking requires your trunk domain in the outbound_address. Format: {your-trunk-domain}.sip-{region}.vonage.com Example: mrassistant-developer.sip-us.vonage.com Find this in Vonage Dashboard → SIP Trunks → Your Trunk → Outbound Calling section.
Response
Successful Response
Response for phone number registration.