Skip to main content

Webhook

Webhook + Pulse Integration Benefits​

  • Forward alert data from Pulse to any external system that supports receiving HTTP POST requests.
  • Customize headers and payload structure for compatibility with your internal systems or third-party services.
  • Enable flexible and extensible integrations using open standards.

How It Works​

Pulse sends alert notifications to the Webhook URL you provide. These notifications are sent as HTTP POST requests in JSON format.

A typical alert payload includes key information such as:

{
  "timestamp": "2025-06-10T10:15:00Z",
  "subject": "Disk space critical",
  "text": "Disk usage on node-1 exceeded 90%",
  "severity": "critical",
  "cluster_name": "production-cluster",
  "cluster_fqid": "org/prod-cluster"
}

You can optionally customize the request by adding additional headers or including extra fields in the payload. This allows you to adapt the alert format to match your internal tools or third-party systems.

Requirements​

  • Access to the monitored cluster in Pulse.
  • A valid external Webhook URL that supports HTTP POST requests (must start with http:// or https://).
  • (Optional) Custom headers or body fields (key-value pairs).

Set Up a Webhook URL​

  1. Identify or configure an endpoint on your system that can receive and process POST requests.
  2. Ensure the endpoint is accessible via public or internal URL (http:// or https://).
  3. (Optional) Define expected headers or body fields for compatibility.

For reference, see this example guide on creating webhooks.

Create a Webhook Alert Destination​

  1. Log in to Pulse and navigate to the monitored cluster.
  2. Go to Preferences > Alerts Destinations.
  3. If no Webhook destination exists, click + Webhook.
  4. Enter the webhook URL.
  5. Set the desired alert severity (recommended: critical only).
  6. Click Save Changes.

Add Webhook Alert Destination

Disable the Webhook Alert Channel​

  1. Log in to Pulse and navigate to the monitored cluster.
  2. Go to Preferences > Alerts Destinations.
  3. Disable the Webhook Alerting Destination by toggling the "enabled" toggle.
  4. Click Save Changes.

Disable Webhook Alert Destination

Uninstall the Webhook Alert Channel​

  1. Log in to Pulse and navigate to the monitored cluster.
  2. Go to Preferences > Alerts Destinations.
  3. Remove the Webhook Alerting Destination by clicking the Remove icon.
  4. Click Save Changes.

Remove Webhook Alert Destination

For support please contact hello@pulse.support.