> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.rhombus.community/llms.txt
> Use this file to discover all available pages before exploring further.

# Rhombus Webhooks

> Configure Rhombus webhooks to receive real-time HTTP POST notifications for camera alerts, door events, sensor thresholds, and button presses without polling.

Rhombus webhooks deliver real-time HTTP POST notifications to your server when events occur — door opens, camera alerts, sensor threshold breaches, button presses, and more. Instead of polling the API, your application receives events as they happen.

## How Webhooks Work

<Steps>
  <Step title="Subscribe to Events">
    Use the Rhombus API to register a webhook URL and specify which event types you want to receive.
  </Step>

  <Step title="Events Occur">
    When a subscribed event happens in your Rhombus environment (e.g., a door is forced open), the system generates an event payload.
  </Step>

  <Step title="Receive Notifications">
    Rhombus sends an HTTP POST request to your registered URL with the event details as a JSON payload.
  </Step>

  <Step title="Process & Respond">
    Your server processes the event and returns a `200 OK` response to acknowledge receipt.
  </Step>
</Steps>

## Event Types

Rhombus supports webhook notifications for a wide range of events across your security infrastructure:

<CardGroup cols={2}>
  <Card title="Camera Events" icon="video">
    Motion detection, analytics alerts, video clips saved, AI-powered detections
  </Card>

  <Card title="Access Control Events" icon="door-open">
    Door open/close, forced entry, access granted/denied, credential scans
  </Card>

  <Card title="Sensor Events" icon="temperature-half">
    Temperature, humidity, and air quality threshold alerts
  </Card>

  <Card title="Device Events" icon="bell">
    Button presses, device online/offline status changes
  </Card>
</CardGroup>

## Sample Webhook Payload

When an event triggers a webhook, Rhombus sends a POST request to your URL with a JSON payload:

```json theme={null}
{
  "uuid": "event-uuid-here",
  "orgUuid": "org-uuid-here",
  "ruleUuid": "rule-uuid-here",
  "triggeredTimestampMs": 1712678400000,
  "deviceEvents": [
    {
      "eventUuid": "device-event-uuid-here",
      "deviceUuid": "camera-uuid-here",
      "deviceType": "CAMERA",
      "locationUuid": "location-uuid-here",
      "timestampMs": 1712678400000,
      "activities": ["MOTION_HUMAN"]
    }
  ],
  "ruleTriggers": [
    {
      "type": "DEVICE_ACTIVITY_EVENT"
    }
  ]
}
```

<Note>
  Webhooks are triggered by the rules you configure in Rhombus. Each payload identifies the rule that fired (`ruleUuid`), the triggers that matched (`ruleTriggers`), and the underlying device events (`deviceEvents`). The specific fields present depend on the triggering event type, so set up a test webhook endpoint to inspect the full payload for your rules.
</Note>

## Managing Webhooks via the API

Use the Webhook Integrations endpoints to manage your webhook subscriptions:

* **Create** a webhook subscription with your endpoint URL and event filters
* **List** active webhook subscriptions for your organization
* **Update** existing subscriptions to change URLs or event types
* **Delete** subscriptions you no longer need

Browse webhook endpoints in the [API Reference](/api-reference/overview) under the Webhook Integrations section.

## Implementation Guide

For a complete guide on setting up a webhook listener — including receiving webhooks on servers behind firewalls using reverse SSH tunneling — see the [Webhook Listener Implementation](/implementations/webhook-listener).

## No-Code Alternatives

If you prefer a visual workflow builder over writing custom webhook handlers, Rhombus integrates with:

* [Zapier](/low-code-no-code/zapier) — instant triggers for rule events, button presses, door events, and sensor alerts
* [Make.com](/low-code-no-code/make) — webhook triggers with advanced data routing
* [n8n](/low-code-no-code/n8n) — self-hosted webhook processing with AI agent capabilities