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.
Supported events
Cachet currently supports the following events:component_createdcomponent_updatedcomponent_deletedcomponent_status_changedincident_createdincident_updatedincident_deletedmetric_createdmetric_updatedmetric_deletedmetric_point_createdmetric_point_deletedsubscriber_createdsubscriber_unsubscribedsubscriber_verified
Receiving webhooks
User agent
Cachet sends thisUser-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 aSignature 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.