Skip to main content

How to send events to Angelcam via HTTP(S)

Create a sensor in MyAngelcam and send events to it with an HTTP(S) request from a camera, alarm panel, script or app.

Written by Ondrej Lanc

Anything that can send an HTTP(S) request can send events to Angelcam: a camera, an alarm panel, a script or your own app. Each event goes to a sensor. The sensor marks the event on the camera timeline, can start event recording on its camera, and can trigger incidents.

There are three ways to send events: via HTTP(S), described here; via e-mail, described in How to send events to Angelcam via e-mail; and via IFTTT, described in How to send events to Angelcam from IFTTT-compatible devices. E-mail isn't real-time, so use HTTP(S) when your device supports it.

Create a sensor

  1. In MyAngelcam, open the dashboard of your location and go to the Sensors tab.

  2. Click Connect a new sensor.

  3. Fill in the form:

    • Name: shown on the camera timeline and in notifications.

    • Type: what the sensor is, for example Camera inbuilt motion detection or Door/window sensor. The setup is the same for all types.

    • Camera: the camera whose timeline shows the events. Each sensor works with one camera.

    • Enable cloud recording for: how long the camera records after each event (30 seconds, 1, 2 or 5 minutes), or Do not start recording to only mark events. See event recording.

    • Incident triggering: Respect system arming (incidents only when the location is armed), Always trigger incident (for example, for smoke detectors) or Never trigger incident (only record and mark events).

    • Enabled: when off, the sensor ignores all events.

    The other fields are optional.

  4. Click Create sensor. The sensor page opens.

    Sensor page with setup instructions

Find the sensor hash

On the sensor page, the Sensor setup instructions section shows the Sensor hash, a short string of letters and numbers such as a1b2c3d4e5. You can open the page later from the Sensors tab of your location.

Warning: Do not share the sensor hash. Anyone who has it can send events to your sensor.

Set up your device to send events

In your camera or device, look for a setting such as HTTP notification, HTTP action or Webhook. Set it to send this request when the device detects something:

  • URL: https://api.angelcam.com/v1/events/

  • Method: POST

  • Header: Content-Type: application/json

  • Body: {"hash": "<sensor hash>"}

Replace <sensor hash> with the hash from the sensor page. No username, password or API token is needed: the hash identifies the sensor.

The body can also contain two optional fields:

  • title: a name for the event, for example "Back door opened".

  • occurred_at: when the event happened, in ISO 8601 format, for example "2026-11-20T14:00:00Z". Without it, Angelcam uses the time the event arrives.

A full body then looks like this: {"hash": "<sensor hash>", "title": "Back door opened"}

If your device can't send a POST request

Some older cameras can only call a URL. In that case, use a GET request with the hash in the URL:

https://api.angelcam.com/v1/events/?hash=<sensor hash>

You can add a title the same way: &title=Back%20door. Use GET only when POST isn't possible.

Check that it works

Trigger your device, then open the sensor page. Received events count and Last event received should update, and the event appears on the camera timeline.

If nothing arrives, check the hash. Angelcam accepts at most 10 events per minute for each sensor; extra requests are rejected until the minute is over.

Developers can find the full specification in the Angelcam API reference.

Camera-specific guides

Did this answer your question?