Skip to main content

incident.io webhook alerts

Early access preview

This feature is in preview phase and is available in Dagster+ in limited early access. Functionality and APIs may change as we continue development. To get early access to this feature, reach out to your Dagster account team. For more information, see the API lifecycle stages documentation.

Automatically create incidents using the incident.io API.

Step 1: Set up authentication credentials​

Follow the incident.io API guide to create an API key and fetch your severity configuration.

In your Dagster+ deployment settings, create an environment variable for the incident.io API key with a descriptive name (for example, INCIDENT_IO_API_KEY). Note the severity ID you'd like to use for alerts created by Dagster+.

Step 2: Configure your alert notification​

Webhook Header: In the Webhook configuration, set the following header:

  • Key: Authorization
  • Value: Bearer {{env.INCIDENT_IO_API_KEY}}

Webhook URL: Use https://api.incident.io/v2/incidents as the URL for your alert webhook.

Webhook Body:

{
  "name": "{{alert_summary}}",
  "summary": "{{alert_content}}",
  "idempotency_key": "{{alert_policy_id}}:{{run_id}}",
  "severity_id": "YOUR_SEVERITY_ID",
  "visibility": "public"
}