Skip to main content
You can configure Cachet to notify external services of various events using webhooks. Webhooks are HTTP callbacks triggered by specific events. When an event occurs, Cachet sends an HTTP POST request to the configured URL with a JSON payload containing information about the event. Webhooks consist of:
  • Payload URL: The URL that Cachet will send the webhook to.
  • Secret: A secret key used to sign the webhook payload. Use it to verify that the payload came from Cachet and not a third party.
  • Events: The events that will trigger the webhook.
To add, edit, or delete webhooks, open Manage Webhooks in the dashboard.

Supported events

Cachet currently supports the following events:
  • component_created
  • component_updated
  • component_deleted
  • component_status_changed
  • incident_created
  • incident_updated
  • incident_deleted
  • metric_created
  • metric_updated
  • metric_deleted
  • metric_point_created
  • metric_point_deleted
  • subscriber_created
  • subscriber_unsubscribed
  • subscriber_verified

Receiving webhooks

User agent

Cachet sends this User-Agent header with each request:

Payload

The payload Cachet sends contains information about the event that triggered the webhook. The payload is a JSON object with the following structure:

Signature verification

When a webhook fires, Cachet sends a Signature header with the request. Use this header to verify the data was not modified in transit. Cachet computes the signature by hashing the request body with the secret key. To verify it, compute the same hash and compare it to the value in the Signature header.

Verifying signatures