Disconnect a customer's WhatsApp account over the Public API

Released: August 9, 2026

DELETE /v1/customers/{id}/whatsapp_accounts/{phone_number_id} Added

Customers connect their own WhatsApp number through a setup link. Until now, once connected, the only way to remove that number was from the dashboard. You can now do it over the Public API.

Identify the account by the phone_number_id returned in GET /v1/customers/{id} (the whatsapp_accounts[].phone_number_id field), then delete it:

curl -sS -X DELETE \
  'https://api.kirimdev.com/v1/customers/cus_335T08.../whatsapp_accounts/1111475158712095' \
  -H 'Authorization: Bearer kdv_live_xxx'

{
  "data": {
    "phone_number_id": "1111475158712095",
    "object": "whatsapp_account",
    "disconnected": true
  },
  "request_id": "req_..."
}

This mirrors removing the account from the dashboard: the number is best-effort unsubscribed from Meta webhooks, the account is soft-deleted, and a full purge of its data is scheduled. The call is scoped to the customer — you can only disconnect an account the addressed customer owns — and idempotent: once the account is gone, a repeat call returns 404 resource_not_found.

Disconnect is destructive

Unlike archiving a customer (which preserves message history), disconnecting an account schedules its data for purge. To reconnect the number, the customer must complete Embedded Signup again through a fresh setup link.

SDK support

@kirimdev/sdk ≥ 3.16.0 exposes it as kirim.customers.disconnectWhatsappAccount:

await kirim.customers.disconnectWhatsappAccount(
  'cus_335T08RM0EAKN9DTE6RD5RWP7B',
  '1111475158712095',
)

Read the Customers docs →