How Webhooks Work
1
Subscribe to Events
Use the Rhombus API to register a webhook URL and specify which event types you want to receive.
2
Events Occur
When a subscribed event happens in your Rhombus environment (e.g., a door is forced open), the system generates an event payload.
3
Receive Notifications
Rhombus sends an HTTP POST request to your registered URL with the event details as a JSON payload.
4
Process & Respond
Your server processes the event and returns a
200 OK response to acknowledge receipt.Event Types
Rhombus supports webhook notifications for a wide range of events across your security infrastructure:Camera Events
Motion detection, analytics alerts, video clips saved, AI-powered detections
Access Control Events
Door open/close, forced entry, access granted/denied, credential scans
Sensor Events
Temperature, humidity, and air quality threshold alerts
Device Events
Button presses, device online/offline status changes
Sample Webhook Payload
When an event triggers a webhook, Rhombus sends a POST request to your URL with a JSON payload: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.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