> For the complete documentation index, see [llms.txt](https://docs.simplifyqa.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.simplifyqa.ai/marketplace/integration-with-project-management-tools/integrating-simplifyqa-with-jira/configure-web-hooks.md).

# Configure Web-hooks

A webhook is a way for an application to provide real-time information to another application. It's like a subscription service where you can subscribe to specific events or actions within a source application. When these events occur, the source application sends an HTTP POST request to a designated URL, carrying relevant data.

### Why Jira Webhooks?

Jira webhooks allow you to automate workflows, integrate with other tools, and receive real-time updates on events within your Jira instance. By setting up webhooks, you can:

* **Automate Issue Creation and Updates:** Automatically create issues in SimplifyQA when issues are created or updated in Jira.
* **Trigger Builds and Deployments:** Initiate builds and deployments in your CI/CD pipeline when specific Jira issues reach certain statuses.
* **Send Notifications:** Receive notifications via email, Slack, or other channels when important events occur in Jira.
* **Integrate with Other Tools:** Connect Jira with other tools like Slack, Microsoft Teams, and more to streamline workflows.

### How to setup Webhook in Jira?

* **Access Jira Settings:** Log in to your Jira account and click on the Settings icon located beside the profile icon.

<figure><img src="https://2640723101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMxErCxeVwmOt7GY9s22U%2Fuploads%2FK1b9YK7D77xeiibW4T21%2Fimage.png?alt=media&amp;token=5e442bce-089b-4bb9-a76b-e800cd76f904" alt=""><figcaption></figcaption></figure>

* **Navigate to the System Settings:** From the settings menu, click on System under Jira settings. You will be redirected to the system settings page.

<figure><img src="https://2640723101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMxErCxeVwmOt7GY9s22U%2Fuploads%2FrVHsvRn9Jq5QipaCvRNB%2Fimage.png?alt=media&amp;token=c792e5db-f44c-4434-a79d-3086d2d69e26" alt=""><figcaption></figcaption></figure>

* **Open the Webhooks Page:** On the left-hand menu, locate and click on Webhooks. This will open the Webhook management page.

<figure><img src="https://2640723101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMxErCxeVwmOt7GY9s22U%2Fuploads%2Fd64yJmKZkEo0Rhi1z8a1%2Fimage.png?alt=media&amp;token=7235be1d-bf88-4083-ad70-853803149fa2" alt=""><figcaption></figcaption></figure>

* **Create a New Webhook:** Click on the Create Webhook button.

<figure><img src="https://2640723101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMxErCxeVwmOt7GY9s22U%2Fuploads%2FzMYzoxQwJJ8N1J53ooAw%2Fimage.png?alt=media&amp;token=0e811c86-97b6-4172-81a5-744f933d87cf" alt=""><figcaption></figcaption></figure>

* **Configure the Name, Webhook URL:** Give the Name of the webhook. In the URL field, provide the webhook URL in the following format:

```
[URL]/jira/integration/[simplifyqa_customerid]/{project.key}
```

```
https://qanewui.simplify.com/jira/integration/1/{project.key}
```

<figure><img src="https://2640723101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMxErCxeVwmOt7GY9s22U%2Fuploads%2FjaCnpo5qXyI07sOKrPLO%2Fimage.png?alt=media&amp;token=02a90877-f96c-4658-b656-0faa18cad019" alt=""><figcaption></figcaption></figure>

* Specify the Jira projects to flow data from Jira to SimplifyQA projects using the following format:

```
project = jira_project_1
```

* To map multiple projects under the same webhook, use the “OR” operator:

```
project = jira_project_1 OR jira_project_2
```

<figure><img src="https://2640723101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMxErCxeVwmOt7GY9s22U%2Fuploads%2Fx53gMguUg1iAJvGvSYCr%2Fimage.png?alt=media&amp;token=f91edc35-4382-4ef6-9d17-c4678c05f76d" alt=""><figcaption></figcaption></figure>

* **Configure Event Fields:** Under the Syntax help section, select all checkboxes for the following event fields, this allows data from Jira to SimplifyQA related to this fields.
  * Issue
  * Comment
  * Attachment
  * Issue Link

<figure><img src="https://2640723101-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMxErCxeVwmOt7GY9s22U%2Fuploads%2FySUzIVKsgNnyM1lIXjW1%2Fimage.png?alt=media&amp;token=cf72e06d-fb3f-4aef-8d39-3d679ef68a4c" alt=""><figcaption></figcaption></figure>

* **Finalise and Save:** Once all fields are configured, click on the Create button. The webhook will now be successfully created and ready for use.