UniFi Protect icon

UniFi Protect

Interact with UniFi Protect API

Actions18

Overview

This node interacts with the UniFi Protect API to retrieve multiple event records based on specified filters. It is useful for scenarios where users want to monitor or analyze events such as motion detection, doorbell rings, or smart detection zones from their UniFi Protect cameras. For example, a user can fetch all motion events within a specific time range or limit the number of events returned for performance reasons.

Use Case Examples

  1. Fetch all motion events from a specific camera within the last 24 hours.
  2. Retrieve up to 100 ring events that occurred between two timestamps.

Properties

Name Meaning
Filters Collection of filters to narrow down the event query, including start time, end time, event type, camera ID, and limit on the number of events returned.
Request Options Settings related to the request behavior, including batching, SSL certificate validation, proxy configuration, and request timeout.

Output

JSON

  • events - Array of event objects matching the query filters, containing details about each event such as type, time, and associated camera.

Dependencies

  • UniFi Protect API

Troubleshooting

  • Ensure the API credentials are correctly configured to avoid authentication errors.
  • Verify that the camera IDs and event types used in filters are valid and exist in the UniFi Protect system.
  • If SSL issues occur, consider enabling the option to ignore SSL certificate validation, especially in self-signed certificate environments.
  • Adjust the timeout setting if requests are timing out due to slow network or server response.

Links

Discussion