UniFi Protect Integration

Ingest camera events, motion alerts, and smart detection notifications from your UniFi Protect system.

Overview

The UniFi Protect integration connects to your Protect controller via the local API and WebSocket event stream. It captures motion events, smart detections, and system alerts in real-time.

Supported Event Types

• Motion events — Triggered motion with camera, zone, and timestamp
• Smart detections — Person, vehicle, animal, and package detection Pro
• Camera alerts — Disconnection, tampering, storage warnings
• System events — NVR disk usage, firmware updates, recording status changes
• Ring events — Doorbell presses with snapshot metadata
• License plate recognition — Detected plates with confidence scores Enterprise

Configuration

Navigate to Instance Settings → Integrations → UniFi Protect and enter your controller details.

Controller URL: https://192.168.1.1:7443
    Username: sentinelnerd-reader
    Password: ********
    Verify SSL: true
    Event Types: motion, smartDetection, ring, sensorAlert

Smart Detection Events

When smart detection is enabled on your cameras, Sentinel Nerd receives detailed classification data:

{
  "type": "smart_detection",
  "camera": "Front Door G4 Pro",
  "detection_type": "person",
  "confidence": 0.94,
  "zone": "driveway",
  "timestamp": "2025-01-15T14:32:01Z",
  "thumbnail_url": "/api/v1/events/evt_abc123/thumbnail"
}

Motion Zones and Schedules

Motion events include zone information from your Protect configuration. Use this in detection rules to filter alerts by area:

name: protect.restricted_area_motion
description: Motion detected in restricted area outside business hours
severity: high
source: unifi_protect
conditions:
  - field: detection_type
    equals: person
  - field: zone
    in: [server_room, warehouse_rear]
  - field: timestamp
    outside_schedule: business_hours
actions:
  - alert:
      channels: [slack, pagerduty]
  - snapshot:
      save: true

Camera Health Monitoring

Sentinel Nerd tracks camera health and alerts on operational issues:

• Offline cameras — Alerts when a camera disconnects for more than 2 minutes
• Storage warnings — NVR disk usage approaching capacity
• Recording gaps — Missing footage detected in retention timeline
• Firmware mismatches — Cameras running different firmware versions

Built-in Detection Rules