API & Integrations
    Feature Guide

    Custom Webhook Integration

    Send alert data to any HTTP endpoint via custom webhooks. Slack and Discord URLs are auto-routed when used in escalation steps.

    Updated 2026-06-15
    2 min read
    webhook
    integration
    custom

    Custom Webhook Integration#

    Pro Plan and Above#

    Send alert data as JSON payloads to any HTTP endpoint — perfect for connecting to tools that don't have a native integration.

    Setup#

  1. Go to Settings → Notifications → Webhooks
  2. Click "Add Webhook"
  3. Enter the endpoint URL
  4. Optionally add custom headers (e.g., authentication tokens)
  5. Choose which alert types trigger the webhook
  6. Send a test payload to verify
  7. Payload Format#

    {
      "event": "site.down",
      "site": {
        "id": "uuid",
        "domain": "example.com",
        "url": "https://example.com"
      },
      "alert": {
        "severity": "critical",
        "message": "Site is not responding",
        "triggered_at": "2026-03-01T10:30:00Z"
      },
      "check": {
        "status_code": 0,
        "response_time_ms": null,
        "error": "Connection timed out"
      }
    }

    Use in escalation policies#

    When you add a step to an escalation policy and paste a webhook URL into the Recipient field, we auto-detect the destination:

  8. URLs containing hooks.slack.com → routed to the Slack webhook channel
  9. URLs containing discord.com/api/webhooks → routed to the Discord channel
  10. Any other https:// URL → posted as a generic webhook
  11. That means one escalation step can target any of those three without extra setup. See Escalation step channels for the full routing matrix.

    Use Cases#

  12. Trigger CI/CD pipelines on performance degradation
  13. Log alerts to your own database
  14. Send to custom Slack bots with enriched context
  15. Integrate with internal incident management tools
  16. Was this article helpful?