Link Search Menu Expand Document

Integrate Jira with Soda

Last modified on 23-Jul-24

Configure a webhook in Soda Cloud to connect to your Jira workspace.

In Jira, you can set up an Automation Rule that enables you to define what you want an incoming webhook to do, then provides you with a URL that you use in the URL field in the Soda Cloud integration setup.

This example offers guidance on how to set up a webhook to generate an external link to which Soda Cloud displays in the Incident Details. When you change the status of a Soda Cloud incident, the webhook also updates the status of the Jira issue that corresponds with the incident. Refer to Event payloads for details information.

webhook-incident


In Jira, start by navigating to Project settings > Automation, then click Create rule and, for the type of New trigger, select Incoming webhook. Reference the Jira documentation for details on how to create an Incoming webhook.

The images below offer details for an example of an Automation Rule in Jira to set up an incoming webhook that processes incident events from Soda Cloud.

See full Jira Automation example


When configuring the Incoming webhook, note the value for the Webhook URL that Jira provides for the automation; input this URL into the Soda Cloud URL field for the webhook (step 4, above).

# Example Webhook URL
https://automation.atlassian.com/pro/hooks/98fbb...
# Example automation rule
curl -X POST -H 'Content-type: application/json' \
https://automation.atlassian.com/pro/hooks/98fbb...

webhook-incoming

webhook-config


When configuring Send web request, note the Web request URL that Jira sends back to Soda Cloud for the incident. This example uses incidentLinkCallbackUrl to send a POST request back to Soda Cloud to display a link to the Jira issue in the Incident Details page.

# Example Web request URL
{{webhookData.incidentLinkCallbackURL}}
# Example Custom data
{
"url": "{{createdIssue.url}}",
"text": "{{createdIssue.key}}"
}

webhook-send-request


When configuring a Branch rule to update the status of an existing Jira issue, note the value in the JQL field that identifies which issue to update when the incident status in Soda Cloud changes.

# Example JQL
summary ~ "SODA-{{webhookData.incident.number}}"

webhook-branch-rule


Go further


Was this documentation helpful?

What could we do to improve this page?

Documentation always applies to the latest version of Soda products
Last modified on 23-Jul-24