MONIX :: WEBHOOK ALERT REFERENCE

Webhook Alerts & Event Notifications

Monix dispatches real-time HTTPS POST JSON webhooks to your alerting endpoints (Slack webhooks, Discord, PagerDuty, or custom backend services) whenever a monitored site enters downtime, recovers, or approaches TLS certificate expiration.

Configuring a Target Webhook

Set your alerting URL via the REST API for any registered target:

PATCH /api/targets/<target-id>
Authorization: Bearer <token>
Content-Type: application/json

{
  "webhook_url": "https://api.yourdomain.com/webhooks/monix",
  "cert_warning_days": 14
}

Event Schemas & Payloads

incident.startedFired on 2 consecutive check failures

{
  "event": "incident.started",
  "target_id": "7b4c9e82-1234-4567-89ab-cdef01234567",
  "url": "https://api.example.com/health",
  "incident_id": "9f8e7d6c-5432-1098-ba98-fedcba098765",
  "started_at": "2026-08-24T12:00:00.000Z",
  "status_code": 503,
  "cause": "HTTP 503 Service Unavailable"
}

incident.resolvedFired when downed site returns 2xx/3xx

{
  "event": "incident.resolved",
  "target_id": "7b4c9e82-1234-4567-89ab-cdef01234567",
  "url": "https://api.example.com/health",
  "incident_id": "9f8e7d6c-5432-1098-ba98-fedcba098765",
  "started_at": "2026-08-24T12:00:00.000Z",
  "ended_at": "2026-08-24T12:15:00.000Z",
  "duration_seconds": 900
}

certificate.expiry_warningFired nightly when cert days <= threshold

{
  "event": "certificate.expiry_warning",
  "target_id": "7b4c9e82-1234-4567-89ab-cdef01234567",
  "url": "https://api.example.com",
  "certificate_expiry_at": "2026-09-02T00:00:00.000Z",
  "days_remaining": 9,
  "cert_issuer": "Let's Encrypt Authority X3",
  "cert_warning_days": 14
}

Delivery & Retry Guarantee

• Timeout: 5 seconds per HTTP request.
• Retry Policy: Automatic 1x retry on non-2xx response code or network connection error.
• User-Agent: Monix-Webhook/1.0
• Content-Type: application/json

Back to Documentation Open Inspector