Send UniFi Protect Alerts to Web Services using Webhooks

UniFi Protect custom webhooks make it easy to connect UniFi Protect with other web services. They allow you to automatically respond to alerts, improve monitoring, and scale effortlessly. With webhooks, you can quickly act on important alerts, reduce manual work, and enhance your security and efficiency.

For details on using webhooks with Slack, read our article here.

Steps to Create a Custom Webhook in UniFi Protect

1. Open UniFi Protect and go to the Alarm Manager section.
2. Select an existing alarm or create a new one to open the Edit Alarms panel.
3. In the Edit Alarms panel, you can:
   • Set the alarm name.
   • Edit the trigger settings, including selecting the devices (cameras & sensors) that will trigger alarms and setting an optional schedule.
4. Scroll to the Action settings.
5. Add an action and select Webhook from the dropdown menu.
6. Choose Custom Webhook.
7. Enter the Webhook Services URL.
8. Click Save.

Advanced Settings

By default, the webhook will create an HTTP GET request each time an alarm is triggered.

For advanced cases, use the Advanced Settings:

• HTTP GET allows custom headers for security tokens or other additional information.
• HTTP POST delivers additional information about the alarm to your service.
  • Here is an example of the HTTP POST structure:
    

    {
      "alarm": {
        "name": "test post",
        "sources": [],
        "conditions": [
          {
            "condition": {
              "type": "is",
              "source": "motion"
            }
          }
        ],
        "triggers": [
          {
            "key": "motion",
            "device": "74ACB99F4E24"
          }
        ]
      },
      "timestamp": 1722526793954
    }