Skip to main content

How to send Angelcam notifications to your server (webhooks)

Add a webhook so Angelcam calls your server when an incident, camera or Angelcam Connector event happens.

Written by Ondrej Lanc

A webhook sends an HTTP request to your server every time an event happens in Angelcam. Events include an incident, a camera or an Angelcam Connector device going offline or online, a camera check result, or arming. Use a webhook to connect Angelcam to your own system, a monitoring center or an automation tool.

For developers: the request format, the fields and how to verify the signature are described in the webhooks guide in the Angelcam developer documentation.

Add a webhook

  1. Click your name in the top right corner, choose Notification Settings and open Webhooks & integrations.

  2. Click Add webhook.

    The Webhooks & integrations page with the Add webhook button
  3. Fill in the dialog:

    • Name: anything that helps you recognize it, for example Monitoring center.

    • URL: the address of your server that receives the request.

    • Send from: choose Angelcam cloud for a server that is reachable from the internet. To reach a server in your own local network, choose an Angelcam Connector device (for example an AngelBox) in that network, and the request goes through it.

    • Events and where: tick the events to send. Each event has its own Where, so you can limit it to some locations or, for camera events, to some cameras.

    The Add webhook dialog
  4. Click Save. Angelcam generates a signing key for the webhook.

What your server receives

Each request is a JSON message with the event details, such as the camera or the incident, and a title and text you can show to people.

Every request is signed. The X-Angelcam-Signature header carries a token made with the webhook's signing key. Check it to be sure the request came from Angelcam. Click How to verify the signature on the page, or see the developer documentation.

To choose other notification channels, see Setting up notifications. For offline and online events, see Camera status monitoring.

Did this answer your question?