Skip to main content

Webhook Events Reference

Complete payload schema for every AlertifyPro webhook event.

monitor.down​

Fired when a monitor transitions from operational to down (after the configured failure threshold).

{
  "event": "monitor.down",
  "timestamp": "2026-03-02T14:23:00Z",
  "data": {
    "monitor": {
      "id": "mon_abc123",
      "name": "Production API",
      "type": "http",
      "url": "https://api.yourapp.com/health"
    },
    "alert": {
      "id": "alt_def456",
      "severity": "critical",
      "reason": "HTTP 503 Service Unavailable",
      "failing_regions": ["us-east-1", "eu-west-1"],
      "consecutive_failures": 2,
      "started_at": "2026-03-02T14:23:00Z"
    }
  }
}

monitor.recovered​

Fired when a monitor returns to operational after an outage.

{
  "event": "monitor.recovered",
  "timestamp": "2026-03-02T14:29:12Z",
  "data": {
    "monitor": { "id": "mon_abc123", "name": "Production API" },
    "alert": {
      "id": "alt_def456",
      "started_at": "2026-03-02T14:23:00Z",
      "resolved_at": "2026-03-02T14:29:12Z",
      "downtime_seconds": 372
    }
  }
}

monitor.degraded​

Fired when a monitor is slow but not fully down (response time threshold exceeded).

{
  "event": "monitor.degraded",
  "data": {
    "monitor": { "id": "mon_abc123", "name": "Production API" },
    "alert": {
      "severity": "warning",
      "reason": "Response time 4823ms exceeds threshold of 3000ms",
      "response_time_ms": 4823
    }
  }
}

incident.created / updated / resolved​

{
  "event": "incident.created",
  "data": {
    "incident": {
      "id": "inc_abc123",
      "title": "API experiencing elevated error rates",
      "status": "investigating",
      "severity": "major",
      "status_page_id": "sp_xyz",
      "affected_components": ["comp_api"],
      "created_at": "2026-03-02T14:23:00Z"
    }
  }
}

ssl.expiring​

{
  "event": "ssl.expiring",
  "data": {
    "monitor": { "id": "mon_abc123", "name": "Production API" },
    "ssl": {
      "hostname": "api.yourapp.com",
      "expires_at": "2026-04-01T00:00:00Z",
      "days_remaining": 30,
      "issuer": "Let's Encrypt"
    }
  }
}

heartbeat.missed​

{
  "event": "heartbeat.missed",
  "data": {
    "monitor": {
      "id": "mon_hb123",
      "name": "Nightly DB Backup",
      "expected_every": "86400s",
      "last_ping_at": "2026-03-01T02:01:00Z",
      "grace_period": "1800s"
    }
  }
}