Skip to main content

Jira 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 tickets using the Jira Cloud REST API.

Step 1: Set up authentication credentials​

Create an Atlassian API Token in your Atlassian profile.

Atlassian requires Basic Auth encoded in Base64 (email:token).

Mac/Linux Command:

echo -n 'your_email@domain.com:your_api_token' | base64

Save the resulting Base64 string as an Environment Variable in Dagster+ (e.g. ATLASSIAN_CREDENTIALS).

Step 2: Configure your alert notification​

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

  • Key: Authorization
  • Value: Basic {{env.ATLASSIAN_CREDENTIALS}}

Webhook URL: Use https://<your-domain>.atlassian.net/rest/api/3/issue as the URL for your alert webhook.

Webhook Body: Build the issue body using Atlassian Document Format (ADF):

{
  "fields": {
    "project": {"key": "ENG"},
    "issuetype": {"name": "Bug"},
    "priority": {"name": "High"},
    "summary": "Dagster Alert: {{alert_summary}}",
    "description": {
      "type": "doc",
      "version": 1,
      "content": [
        {
          "type": "paragraph",
          "content": [
            {
              "type": "text",
              "text": "Details:\n",
              "marks": [{"type": "strong"}]
            },
            {
              "type": "text",
              "text": "{{alert_content}}",
              "marks": [{"type": "code"}]
            }
          ]
        },
        {
          "type": "paragraph",
          "content": [
            {
              "type": "text",
              "text": "View in Dagster",
              "marks": [{"type": "link", "attrs": {"href": "{{deployment_url}}"}}]
            }
          ]
        }
      ]
    }
  }
}

Official References​