# 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="/files/O6XJe8oXuvLUCPxTm9LV" 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="/files/q7PY3HLRFCz0UxJXSpTK" 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="/files/Io64yNBoJT6XScPXSCYj" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/CM7rntn5VH9FoDj0GhXy" 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="/files/GppSsbGSUElMqkRPNluH" 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="/files/VDYwdZHkHZnjRFmdZJ1j" 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="/files/5tnJOx0hk5mhNeVSGw3X" 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.


---

# Agent Instructions: 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://docs.simplifyqa.ai/marketplace/integration-with-project-management-tools/integrating-simplifyqa-with-jira/configure-web-hooks.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.