Webhooks

Coming soon: Webhook delivery is on the roadmap and not yet available. This page documents how it will work so you can plan ahead.

Webhooks send a structured JSON POST to a URL you control whenever something happens — a monitor goes down, recovers, or a certificate nears expiry. Use them to connect Spectra to any tool that can receive an HTTP request.

Events

Common event types include:

• monitor.down
• monitor.recovered
• ssl.expiring
• domain.expiring
• heartbeat.missed
• latency.degradation

Payload

Each request includes the event, the monitor, its status, and the regions that observed it:

{
  "event": "monitor.down",
  "monitor": "api.yoursite.com",
  "status": 500,
  "regions": ["IN", "SG", "EU"]
}

Building a reliable receiver

• Respond 2xx fast, then process asynchronously so a slow downstream doesn’t cause retries.
• Be idempotent — dedupe on the event id or monitor + timestamp so one outage doesn’t open five tickets.
• Switch on the event type so recovery events close what down events opened.
• Verify the source (expected IPs or a shared secret) before acting.

Don’t see a built-in integration for your tool? A webhook covers it. To manage monitors programmatically, see the REST API.