Skip to main content
POST
/
customers
/
{customer_id}
/
whatsapp
/
phone_numbers
curl --request POST \
  --url https://api.kapso.ai/platform/v1/customers/{customer_id}/whatsapp/phone_numbers \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{
  "whatsapp_phone_number": {
    "name": "Support Line",
    "kind": "production",
    "phone_number_id": "1234567890",
    "business_account_id": "98765432109",
    "access_token": "EAABsbCS...long-lived-token",
    "webhook_destination_url": "https://yourapp.com/webhooks/whatsapp",
    "webhook_verify_token": "your-verify-token",
    "inbound_processing_enabled": true,
    "calls_enabled": false
  }
}'
{
  "data": {
    "id": "1234567890",
    "internal_id": "4a5b6c7d-8e9f-0a1b-2c3d-4e5f6a7b8c9d",
    "phone_number_id": "1234567890",
    "name": "Support Line",
    "business_account_id": "98765432109",
    "is_coexistence": false,
    "inbound_processing_enabled": true,
    "calls_enabled": false,
    "webhook_verified_at": "2025-01-15T10:10:00Z",
    "created_at": "2025-01-15T10:00:00Z",
    "updated_at": "2025-01-15T10:10:00Z",
    "customer_id": "3f2e1d0c-9b8a-7f6e-5d4c-3b2a1f0e9d8c",
    "display_name": "Support Line",
    "display_phone_number": "+1 555-123-4567",
    "display_phone_number_normalized": "15551234567",
    "verified_name": "Acme Corp",
    "quality_rating": "GREEN",
    "code_verification_status": "COMPLETED",
    "name_status": "APPROVED",
    "status": "CONNECTED",
    "throughput_tier": "TIER_10K",
    "whatsapp_business_manager_messaging_limit": "10000",
    "is_official_business_account": false,
    "is_pin_enabled": true
  }
}

Authorizations

​
X-API-Key
string
header
required

Path Parameters

​
customer_id
string<uuid>
required

Body

application/json
​
whatsapp_phone_number
object
required

Response

Phone number connected

​
data
object
required