> For the complete documentation index, see [llms.txt](https://savah.gitbook.io/savah/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://savah.gitbook.io/savah/integration/setting-up-webhooks-in-jira.md).

# 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>

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfCyv3zdeMwSrDM-oZaEjPuk7Fxef0824UXcz6UND3LRoB-j6HNdZsWevcApy-H92eWDjiTVdBBXaDGfpSu5gzFoM-bHK08e7__nbjPUsRM36hFmobLWxWsZgOKZfXDWpW1N7bjkA?key=8ffgRkaJsDDQWKDhzH-KFRu7" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/m5wiAHby3qIZbRgcdDj2" alt=""><figcaption></figcaption></figure>

***

**2. Set Up the Webhook in Jira**

To configure the webhook in Jira, follow these steps:

1. Open Jira Administration.
2. Navigate to System Settings > Webhooks, or directly go to:\
   <https://yourdomain.atlassian.net/plugins/servlet/webhooks\\>
   (Replace "yourdomain" with your Jira instance URL.)

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXc1k76624wqXhi1NF4lfT8VCaSsqqQ96RFb62eHQkcwpIDbMjAjr252ig05B34Sc7M3RyJ0nxgTZHHaJ1RA1XW45MaTbKzhGJ6cB2Vqpj8QzyN57iW4Dg0je3jzVZ5G4ejKoZC58g?key=8ffgRkaJsDDQWKDhzH-KFRu7" alt=""><figcaption></figcaption></figure>

**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.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXf2l8HC75Ja6O21mFTPgmpt1AHMi0PoxDb-KxAnGt7R34lgY7BDiAW4wRE2dD2NcmT1wISnpYf1j6h6wGHaKtJcDilTHxttS2loWa3R_vJSKmwFs58U8yRCcK-WMm4_hnHm80zNxg?key=8ffgRkaJsDDQWKDhzH-KFRu7" alt=""><figcaption></figcaption></figure>

**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

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXf1FF-snIaAwt8HrU36b4mlpuJzUHKNahysoh0gNusxs7ueePXDIjRewk67qC5Wy9yxpz_2vBjxskVBtDKPY2UmKN-ExB6wGCFYze1BxnpiLgJxUWTdRfkSCautPKbJDb-7xZvG?key=8ffgRkaJsDDQWKDhzH-KFRu7" alt=""><figcaption></figcaption></figure>

***

#### 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.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXeypMPGMNGC4kFeyzbeIDJ_joTbpfoZfMn9foiyTedsZphQWXxtlCFPWncPPcDwkkaZUbUvkJmO2k2zl4Dqa4eiGEd4YumX88L33J80wf-03iBQIigLX1AGEP0CGWMUYpIG_zS0?key=8ffgRkaJsDDQWKDhzH-KFRu7" alt=""><figcaption></figcaption></figure>

**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.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://savah.gitbook.io/savah/integration/setting-up-webhooks-in-jira.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.