Skip to content

Integrate with n8n

Automate Rhombus security workflows in self-hosted n8n with the official community node — orchestrate cameras, access control, IoT sensors, and AI agents.

On this page

Automate your Rhombus security platform with n8n, a self-hostable workflow automation tool. The official Rhombus node for n8n (an n8n community node) gives you native access to cameras, doors, events, users, and more — no raw HTTP configuration needed.

Info

Official Community Node: @rhombussystems/n8n-nodes-client provides 11 resource types with 41 operations, all validated against the Rhombus OpenAPI spec.

Install the Rhombus Node

  1. Open n8n Settings

    In your n8n instance, go to Settings > Community Nodes.

  2. Install the package

    Enter the package name and click Install:

    @rhombussystems/n8n-nodes-client
  3. Add your API key

    When you first add a Rhombus node to a workflow, n8n prompts you to create credentials:

    1. Go to the Rhombus Console and generate an API key
    2. In n8n, create a new Rhombus API credential
    3. Paste your API key and save

    The node automatically handles the x-auth-apikey and x-auth-scheme headers.

Available operations

The Rhombus node provides 41 operations across 11 resource types:

Access control

OperationDescription
Assign CredentialAssign an existing badge credential to a user
Create Access GrantCreate a new access grant for users or groups
Create CredentialCreate a new standard CSN badge credential
Delete Access GrantDelete an existing access grant
Get User Access GrantsGet all access grants assigned to a user
Revoke CredentialRevoke a badge credential (preserves history)

Cameras

OperationDescription
GetGet full state of a single camera
Get ManyGet a list of many cameras in the organization
Create ClipCreate a video clip from a camera
Create Shared StreamCreate a shareable live video stream URL
Get FrameGet a URL for an exact frame image from a camera
Get Media URIsGet live and VOD stream URIs for a camera
UpdateUpdate camera details

Doors

OperationDescription
Get ManyGet a list of many access-controlled doors
UnlockTemporarily unlock an access-controlled door
Get EventsGet access event history for a door

Events

OperationDescription
Get AlertsGet policy alerts from the organization
Get ManyGet a list of saved video clips

Face recognition

OperationDescription
Create PersonCreate a new known person for face recognition
Delete PersonDelete a known person from face recognition
Get ManyGet a list of many known persons in the organization
Search Face EventsSearch face recognition events with filters

Lockdown

OperationDescription
ActivateActivate a lockdown for a location
DeactivateDeactivate a lockdown for a location
Get ManyGet a list of many lockdown plans in the organization
Get StatusGet lockdown status for all locations

Organization

OperationDescription
GetGet organization information
Get LocationsGet a list of locations in the organization
UpdateUpdate organization general settings

Sensors

OperationDescription
Get ManyGet a list of many climate sensors in the organization
Get Sensor EventsGet climate events for a specific sensor
Get Environmental GatewaysGet current state of all environmental gateways

Users

OperationDescription
CreateCreate a new user in the organization
Get ManyGet a list of many users in the organization
UpdateUpdate an existing user

Vehicles

OperationDescription
Get ManyGet a list of many saved vehicles in the organization
Save VehicleSave and name a vehicle by license plate
Search EventsSearch vehicle/LPR detection events

Webhooks

OperationDescription
GetGet the webhook integration configuration
Create/UpdateCreate or update webhook integration settings
DeleteDelete the webhook integration

Example workflows

Daily security alert report

Generate a daily summary of security alerts and send to your team.

Schedule Trigger (daily at 8 AM)
  ↓
Rhombus Node → Event → Get Alerts (last 24 hours)
  ↓
Code Node → Format alert summary
  ↓
Email Node → Send to security team

Scheduled unlocks

For doors that should open on a schedule, such as a conference room during booked meetings, use door schedules and schedule exceptions in Rhombus rather than an automation: they keep working when the automation platform doesn't, and they're visible to your administrators in the console. If a workflow must unlock a door, add a step where a person approves each run.

Camera clip on alert

Automatically save a clip when a policy alert fires.

Schedule Trigger (every 5 minutes)
  ↓
Rhombus Node → Event → Get Alerts (last 5 minutes)
  ↓
Rhombus Node → Camera → Create Clip (from alert device, 60 seconds)

User onboarding automation

Create Rhombus accounts when employees join from your HR system.

Webhook Trigger (from HR system)
  ↓
Rhombus Node → User → Create (email, name from payload)

AI agent workflows

n8n's AI agent capabilities let you build intelligent security workflows by combining Rhombus data with LLMs.

Conversational security assistant

Build a Slack bot that can query Rhombus data:

Slack Trigger → "Show me camera status"
  ↓
AI Agent with Rhombus tools:
  ├─→ Camera → Get Many (list cameras)
  ├─→ Event → Get Alerts (recent alerts)
  └─→ Camera → Create Clip (save footage)
  ↓
AI Response → Slack

Anomaly detection

Detect unusual access patterns and alert the security team:

Schedule Trigger (every 15 minutes)
  ↓
Rhombus Node → Door → Get Events (last 15 minutes)
  ↓
AI Agent → Analyze patterns for anomalies
  ↓
IF anomaly detected → Create incident + alert team

Advanced: HTTP request fallback

For operations not yet covered by the community node — or to target the EU region (replace the host with api2.eu.rhombussystems.com) — use n8n's HTTP Request node with manual authentication:

json
{
  "method": "POST",
  "url": "https://api2.rhombussystems.com/api/camera/getMinimalCameraStateList",
  "authentication": "predefinedCredentialType",
  "sendHeaders": true,
  "headerParameters": {
    "parameters": [
      {
        "name": "x-auth-apikey",
        "value": "={{$credentials.rhombusApiKey}}"
      },
      {
        "name": "x-auth-scheme",
        "value": "api-token"
      }
    ]
  }
}
Tip

The Rhombus API has more than 1,000 endpoints. The community node covers the most common operations, but you can access any endpoint via HTTP Request nodes. See the API Reference for the full endpoint list.

Deploy n8n

bash
docker run -it --rm \
  --name n8n \
  -p 5678:5678 \
  -v ~/.n8n:/home/node/.n8n \
  n8nio/n8n

Access at http://localhost:5678

Compatibility

RequirementVersion
n8nA recent version that supports community nodes
Node.jsA version supported by your n8n release (for self-hosted)
Rhombus APIThe community node targets api2.rhombussystems.com (US region)

For Rhombus API rate limits, see Rate Limits.

Troubleshooting

Node not appearing after install

Restart your n8n instance after installing the community node. For Docker, restart the container.

Authentication errors

Verify your API key is active in the Rhombus Console. Ensure the credential in n8n has the correct key value.

Rate limit errors

Add Wait nodes between Rhombus operations in loops to spread requests over time. See Rate Limits for current limits and retry guidance.

Webhook not receiving events

Check that your n8n instance is publicly accessible. Verify the webhook URL in the Rhombus Console matches your n8n webhook endpoint.

Resources