Receiving Events

account.auth.succeeded

Authentication finished and the account is online.

Event payload

{
  "id": "evt_auth_4d5e6f7a8b",
  "type": "account.auth.succeeded",
  "provider": "whatsapp",
  "account_id": "acc_8c21d0",
  "occurred_at": "2026-06-08T13:24:00Z",
  "data": {
    "account": { "provider_account_ref": "8613800138000" },
    "auth_status": "authorized",
    "runtime_status": "ready",
    "event": {
      "kind": "account_auth_status",
      "auth_status": "authorized"
    }
  }
}

Notes

Authentication finished. Store data.account.provider_account_ref when present; it is the stable provider identity to correlate later messages and receipts.