Skip to main content
POST
Create Phone Number

Authorizations

Authorization
string
header
required

API key authentication.

X-User-ID
string
header
required

Required user id for API key requests.

Body

application/json
phone_number
string
required

For Twilio/Vobiz: E.164 (e.g. +16504601060). For WhatsApp: Phone Number ID from Facebook Developer Portal

provider
string
default:twilio

Telephony provider. Supports: twilio, whatsapp, vobiz

account_sid
string | null

Twilio Account SID (AC...) - Required for provider=twilio

auth_token
string | null

Twilio Auth Token - Required for provider=twilio. For Vobiz: auth token from Vobiz dashboard

auth_id
string | null

Vobiz Auth ID - Required for provider=vobiz

whatsapp_token
string | null

WhatsApp Access Token - Required for provider=whatsapp

label
string | null

Friendly label for this phone number

Response

Successful Response

id
string
required
provider
string
required
phone_number
string
required
status
string
required
label
string | null
created_at
string | null