API Reference
Receiving Events

account.status.updated

The account runtime / connection status changed.

Event payload

{
  "id": "evt_acc_1a2b3c4d5e",
  "type": "account.status.updated",
  "provider": "telegram",
  "account_id": "acc_8c21d0",
  "occurred_at": "2026-06-08T13:20:00Z",
  "data": {
    "account": { "provider_account_ref": "778899" },
    "auth_status": "authorized",
    "runtime_status": "disconnected",
    "event": {
      "kind": "account_auth_status",
      "auth_status": "authorized",
      "runtime_status": "disconnected"
    }
  }
}

Notes

  • An account auth or runtime state changed. data.auth_status and data.runtime_status are the values to mirror locally; data.account.provider_account_ref appears when the provider identity is known.