Skip to main content
POST
/
phone-numbers
Create Phone Number
curl --request POST \
  --url https://api.staging.kathan.tech/phone-numbers \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'X-User-ID: <api-key>' \
  --data '
{
  "phone_number": "<string>",
  "provider": "twilio",
  "account_sid": "<string>",
  "auth_token": "<string>",
  "whatsapp_token": "<string>",
  "label": "<string>"
}
'
{
  "id": "<string>",
  "provider": "<string>",
  "phone_number": "<string>",
  "status": "<string>",
  "label": "<string>",
  "created_at": "<string>"
}

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: phone number in E.164 format (e.g. +16504601060). For WhatsApp: Phone Number ID from Facebook Developer Portal

provider
string
default:twilio

Telephony provider. Supports: twilio, whatsapp

account_sid
string | null

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

auth_token
string | null

Twilio Auth Token - Required for provider=twilio

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