Webhooks

Receive real-time events from VRSJO to your endpoint — no polling required.

Setup Steps

1

Register endpoint URL

Go to Admin > Webhooks and enter the HTTPS URL VRSJO should POST events to.

2

Choose event types

Select which events trigger notifications — you can subscribe to individual events or all.

3

Verify signature

Each request includes an X-VRSJO-Signature-256 header. Validate it using your shared secret.

4

Handle payload

Parse the JSON body, respond with HTTP 200 within 5 seconds, and process asynchronously.

Example Payload

{
  "id": "evt_01HZ3M4K5X7Y8Z",
  "type": "device.connected",
  "created_at": "2026-05-08T10:30:00Z",
  "data": {
    "device_id": "dev_abc123",
    "name": "Edge Router #7",
    "status": "online",
    "ip": "192.168.1.42"
  }
}

Event Types

EventDescription
device.connectedA device comes online
device.offlineA device loses connection
alert.triggeredAn alert condition is met
alert.resolvedAn alert is cleared
user.createdA new user joins the workspace
sync.completedA content sync job finishes
Home
Home