Unifi Protect KeyFob Support to trigger a rule/event

Get Help Integrations
,
1

Team - I am trying to build a integration automation between Unifi Protect and Habitat -

Use case:

When the Unifi Protect Keyfob has a button press (In this case left side button, single press), trigger/toggle a light managed in Hubitat on. When the button is presss again, triple/toggle a light managed in Habitat off. Below is the Unifi Protect integration log output when the button is pressed:

app:462026-08-18 11:52:13.132 amdebugParsed JSON: [item:[metadata:[button:[text:left]], start:1787079133459, end:1787079133459, id:6a84a9dd01cc0503e41d47a1, type:sensorButtonPressed, device:6a78faa4027c0503e40c13c8, modelKey:event], type:add]

app:462026-08-18 11:52:13.130 amdebugcomponentParse: {"item":{"id":"6a84a9dd01cc0503e41d47a1","modelKey":"event","type":"sensorButtonPressed","start":1787079133459,"end":1787079133459,"device":"6a78faa4027c0503e40c13c8","metadata":{"button":{"text":"left"}}},"type":"add"}

dev:902026-08-18 11:52:13.127 amdebugparse: {"item":{"id":"6a84a9dd01cc0503e41d47a1","modelKey":"event","type":"sensorButtonPressed","start":1787079133459,"end":1787079133459,"device":"6a78faa4027c0503e40c13c8","metadata":{"button":{"text":"left"}}},"type":"add"}

Is there a potential that the integration does not have a integration yet in place to recognized the button push (left, right, single press, double press, long press) of the key fob.

If not, from the log, can there be an actual trigger that can be tagged from this log data that would allow me to enable the integration as an iterim.

The other detail is, when the unifi protect key fob triggers a "Arm Away" profile, will that in the log give a tag of relevance that I could trigger an event as described in the use case above to satisfy the use case

Any help is great appreciated.

2

I think the first thing to confirm is what Unifi Protect integration are you refering to. Is it the Built-in one or Snell's or even another?

Does the fob create a device on Hubitat currently?

Does the Unifi Alarm Manager give you a way to use those button pressds as triggers?

3

It’s the native UniFi inside Hubitat as supported. The keyfob does not show up as a native device.

you can setup in UniFi the trigger for each button and whether a single press, double or long press as well

4

Webhook is also an option in UniFi but the maker API just looks overly complicated for this setup unless someone can clearly lay it out. The Hubitat and UniFi protect systems are all in the same local subnet (192.16.10.0/24)

5

I have been looking to add the Keyfob to my drivers (it will need a new child device to handle the buttons properly). If you are willing to set up mine (it should be able to run at the same time as the Hubitat as they are different APIs) and be a bit of a guinea pig, I would love to get some information about it so I can properly support it going forward.

6

@snell - I would be willing to enable logging to execute whatever you need from Unifi side that would display in log details in hubitat. Just let me know the sequence of what you would like me to do in order to get you the initial set of information. Aside from that, I was able to work through claude code and create the use case via maker API an webhook functions in Unifi Protect. There is a link below to a tutorial that claude wrote on the use case so other that might find this article have a near term way, one that works, to support integration and automated uses cases between Hubitat and Unifi Protect.

Tutorial link here: Claude Artifact