Docs

Webhooks

Receive real-time notifications when incidents occur.

Overview

Configure webhooks to receive HTTP POST requests when dbaBrain detects incidents, health score changes, or other events.

Configuration

In Settings > Integrations > Webhooks, add your endpoint URL. dbaBrain will send a POST request with a JSON payload for each event.

Payload Format

json
{
  "event": "incident.created",
  "timestamp": "2026-02-07T14:30:00Z",
  "data": {
    "id": "inc_xyz789",
    "severity": "P2",
    "title": "Blocking chain detected",
    "database": "production-primary",
    "suggestedFix": "SELECT pg_terminate_backend(8842);"
  }
}

Event Types

  • -incident.created - new incident detected
  • -incident.resolved - incident auto-resolved
  • -health.degraded - health score dropped below threshold
  • -health.recovered - health score returned to normal
  • -database.disconnected - lost connection to database
  • -database.reconnected - connection restored