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

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
phone_number
string
required

Twilio phone number in E.164 format, e.g. +16504601060

account_sid
string
required

Twilio Account SID (AC...)

auth_token
string
required

Twilio Auth Token

provider
string
default:twilio

Telephony provider (future-proof). Currently supports: twilio

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