Webhook event

connection.disconnected

One of your WhatsApp numbers lost its session — vendors in its groups can’t be reached until it’s re-linked in the dashboard.

Delivery#

Sent as a signed POST to your project’s webhook URL — see the Webhooks guide to verify the signature. Delivery is at-least-once: dedupe on the X-Kardlane-Delivery header (or data.idempotencyKey).

Payload

{
  "id": "0f3c9a52-8d6e-4f0e-9b7a-2c1d5e8f4a10",
  "apiVersion": "2026-09-01",
  "type": "connection.disconnected",
  "createdAt": "2026-10-03T09:21:07.512Z",
  "tenantId": "b1e2c3d4-5f60-4a7b-8c9d-0e1f2a3b4c5d",
  "data": {
    "tradeId": "",
    "externalRef": "",
    "settlementMode": "verdict_only",
    "evidence": {},
    "reason": "WhatsApp number \"Ops line\" disconnected",
    "idempotencyKey": "conn:…"
  }
}