Home Assistant Community — Smart Home — Sat, 29 Aug 2026 12:38:06 +0000
Summary
A Home Assistant developer is asking whether a custom integration can detect when a ZHA pairing window is open and when a Zigbee device joins or is re-paired, running HA 2026.8.3 with zha 2.1.0. They report that the ZHA panel's Add Device function uses the zha/devices/permit websocket command rather than the zha.permit service, so nothing appears on the event bus, and that zha_event only fires repeated device_offline messages during re-pairing while remaining silent when a new device joins. They also note that zigpy does not appear to track whether a pairing window is open. The only option they have identified is the zha_gateway_message dispatcher signal, which carries device_joined and device_fully_initialized, but they are reluctant to depend on it without knowing if it is stable. They ask whether a supported hook exists or whether this functionality is simply not exposed.
Is there a way for a custom integration to know when a ZHA pairing window is open, and when a device joins or is re-paired?
What I have ruled out on HA 2026.8.3 with zha 2.1.0:
zha/devices/permit websocket command, not thezha.permit service, so nothing appears on the event bus.zha_event firesdevice_offline repeatedly while an existing device is being re-paired, but nothing at all when a new device joins.The zha_gateway_message dispatcher signal looks like it carries device_joined and device_fully_initialized, but I would rather not depend on it if there is something better, or if it is likely to change.
Is there a supported hook, or is this genuinely not exposed?
Original article: https://community.home-assistant.io/t/detecting-zha-pairing-mode-from-a-custom-integration/1023121 Source: Home Assistant Community