Setting Up Webhooks in Jira
When integrating Savah with Jira through a Jira Integration Account, a webhook is usually created automatically. However, if you do not have "System Admin" or "Super Admin" rights in Jira, the webhook cannot be set up automatically, and you will need to complete the process manually by following the steps below.
Without a webhook, any changes made in Jira will not be instantly reflected in Savah. Instead, you may need to manually Resync your board frequently to update the data.
How to Manually Create a Webhook in Jira
1. Get the Webhook URL from Savah
To begin, navigate to the Jira Integration Account section in Savah and copy the provided webhook URL. Only users with Super Admin privileges can access this URL:
https://app.savahapp.com/integrations
2. Set Up the Webhook in Jira
To configure the webhook in Jira, follow these steps:
Open Jira Administration.
Navigate to System Settings > Webhooks, or directly go to: https://yourdomain.atlassian.net/plugins/servlet/webhooks (Replace "yourdomain" with your Jira instance URL.)
2.1 Creating a Webhook
Click Create a Webhook.
Provide a Name to identify the webhook.
Paste the Webhook URL copied from Savah into the URL field.
2.2 Selecting Events to Track
To ensure seamless data synchronization, enable the following event categories:
Issue Events
Issue Created
Issue Updated
Issue Deleted
Issue Link Events
Issue Link Created
Issue Link Deleted
Sprint Events
Sprint Created
Sprint Started
Sprint Closed
Using JQL to Filter Webhook Scope
Jira Webhooks allow the use of JQL (Jira Query Language) to filter which events are sent to Savah. This is especially helpful for larger Jira instances with many projects and issue types.
You can tailor the webhook to:
Include only specific projects that are actively linked to Savah workspaces and boards.
Limit the scope to specific issue types that are relevant to your planning in Savah.
Example JQL Use Case
In the webhook configuration screen, you can add a JQL query such as:
project in (ABC, XYZ, TEST) AND issuetype in (Story, Bug, Task)
This ensures that only updates from the listed projects and issue types are sent to Savah.
Note: When onboarding a new team in Savah, make sure to update the webhook JQL query to include their project(s). This keeps all relevant data flowing into Savah automatically.
Last updated