protect_subscribe_events
Read-only
Subscribe to UniFi Protect events via WebSocket, collect motion, ring, smart detect, sensor, and other events for a configurable duration (1-30 seconds).
Instructions
Connect to the Protect event WebSocket and collect messages for a specified duration (1-30s). Returns {messages, duration, error?}; each event message includes: id, type ('motion' | 'ring' | 'smartDetectZone' | 'smartDetectLine' | 'sensorMotion' | 'sensorAlarm' | 'fingerprint' | 'nfcCard' | ...), start, end (null while ongoing), camera/sensor id, score, smartDetectTypes (['person','vehicle','animal','package','license_plate','face']), metadata (e.g. detected license plate text, NFC card id, fingerprint id, ULP user match).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| duration | No | Seconds to listen (1-30, default 5) |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| messages | No | Captured WebSocket messages (add/update/remove or event envelopes) | |
| duration | No | Actual listen duration in seconds (number) | |
| error | No | Connection error, if any |