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#
{
"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.
| Header | Contains |
|---|---|
x-auditgate-delivery | A unique ID for this delivery |
x-auditgate-timestamp | When it was sent, in Unix seconds |
x-auditgate-signature-256 | An HMAC-SHA256 signature of the body |
Responding#
- Reply with any
2xxstatus 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.
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);
});