Webhooks Integration

Integrate Cronitor with your system by registering a webhook URL for Cronitor to call when your monitors fail and recover.

Cronitor can send webhook alerts to any URL that can accept an HTTP POST request. You can create routes within your own application, or register Cronitor as a webhook sender in connector systems like Zapier or IFTTT.

Webhook Fields

Webhooks include the following fields:

  • id - string - The unique key for the monitor that generated the alert
  • monitor - string - The name of the monitor that generated the alert
  • title - string - The monitor name and what happened, on one line, e.g. nightly-backup: Failed at 2:01 AM PST with exit code 1. Use it as the title in an incident or ticketing tool.
  • message - string - What happened and when, e.g. Failed at 2:01 AM PST with exit code 1. A recovery has two lines, e.g. Heartbeat detected at 2:05 AM PST. and Resolved after 3 minutes.
  • description - string - A longer description of the alert, with its details and links
  • type - enum Alert|Recovery - Whether this is an alert or a recovery from a previous alert
  • severity - enum critical|warning|info - critical for a failure, warning for a warning, info for a recovery, a run, a complete, or a tick (HasTick)
  • dedup_key - string - The same for an alert and its recovery. One per monitor and environment.
  • issue - string - The name of the issue this alert opened or updated, or null
  • issue_type - string - The kind of issue, e.g. Failed Execution, Missed Execution or SSL Expiring. An alert and its recovery have the same value.
  • rule - string - The specific assertion/rule violation that led to the alert
  • environment - string - The environment this alert was generated for
  • group - string - The name of the group this monitor belongs to, or null
  • issue_url - url - A link to the issue details, or null
  • monitor_url - url - A link to the monitor details

Adding a Webhook

  1. From the Settings > Integrations page, click the Create Integration button and select Webhooks.
  2. Give the webhook a name. This will be used in the Cronitor UI.
  3. Give the webhook a unique identifier. This can be used in the Cronitor API.
  4. Add the URL that will receive the webhook POST requests and press "Create Integration" to complete the integration.
  5. Next, you'll be prompted to add this integration to one or more Notification Lists.
  6. You're done

From the API

Create this destination with the Integrations API.