Skip to content

Connect

Webhooks

Receive AuditGate alerts in your own systems.

Create an alert rule with Webhook as the channel and enter an HTTPS URL you control. AuditGate sends a POST with a JSON body whenever the rule fires.

What you receive#

Example
{
  "deliveryId": "6c1f0e8a-…",
  "alertRuleId": "0b7d2c41-…",
  "condition": "critical_finding",
  "finding": {
    "id": "f3a9c2e1-…",
    "title": "Another user's order is readable on GET /orders/:id",
    "severity": "critical",
    "confidence": "confirmed",
    "status": "open",
    "endpointMethod": "GET",
    "endpointPath": "/orders/:id",
    "detectedAt": "2026-11-18T09:42:11.000Z"
  },
  "scan": null
}

condition is one of critical_finding, high_finding, scan_completed, latency_exceeds or error_rate_exceeds. Whichever of finding or scan doesn't apply is null.

HeaderContains
x-auditgate-deliveryA unique ID for this delivery
x-auditgate-timestampWhen it was sent, in Unix seconds
x-auditgate-signature-256An HMAC-SHA256 signature of the body

Responding#

  • Reply with any 2xx status within 10 seconds. Do slow work afterwards.
  • Redirects aren't followed, so use the final URL.
  • Failed deliveries are retried. Each attempt shows in the rule's delivery history.
  • The URL must be public. Private and internal addresses are refused.
Express
app.post("/hooks/auditgate-7Qm3x9", express.json(), (req, res) => {
  const sentAt = Number(req.header("x-auditgate-timestamp"));
  if (!sentAt || Date.now() / 1000 - sentAt > 300) return res.sendStatus(400);
  if (seen(req.header("x-auditgate-delivery"))) return res.sendStatus(200);

  queue.add("auditgate-event", req.body);
  res.sendStatus(202);
});