Webhooks

Prev Next

Alert Webhooks let you send Catchpoint alerts to web-based APIs. This is helpful for automatically feeding Catchpoint alerts into other systems.

The APIs that you send alerts to are referred to as "subscribers." Each subscriber is added to Catchpoint under Integrations > Webhook. Catchpoint will push alert data to subscribers via an HTTP Post request the moment the alert is triggered.

Configuration

You can configure one or more webhooks to receive Alerts under Integrations > Webhook. Click Add URL to get started, then complete the fields:

  • Name - a friendly name for this subscriber
  • Status - specifies whether this subscriber is active
  • URL - the complete URL of the API endpoint that Catchpoint will post alert data to
  • Format - the formatting of the data posted by Catchpoint. Choose JSON or XML to have Catchpoint post the data using the default template. Choose Template to specify your own format for the posted data. Templates support macros for variable data.
  • On Failure Alert - specify one or more email addresses that will receive notification if the Alert Webhook fails when attempting to post an alert.
  • Notification Trigger - the number of failed attempts that must occur before a notification is sent to email.
  • Apply to
    • All Alerts - All configured alerts will be sent to this webhook
    • No Alerts - Only alerts specifically configured for this webhook will be sent

Notification Levels

The Alert Webhook sends includes an Alert Level. Catchpoint supports three levels of notification which determine the status/importance of an alert.

Level ID Description
Warning 0 Lower severity alert
Critical 1 Higher severity alert
(System Internal) 2 Not used
Improved 3 Indicates the condition that previously triggered a Warning or Critical alert has improved to acceptable level