> For the complete documentation index, see [llms.txt](https://docs.hivel.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hivel.ai/integrations/project-management/jira/jira-using-oauth/how-to-integrate-jira-cloud-with-hivel.md).

# How to integrate Jira Cloud with Hivel

1. Log in to your Hivel account.
2. In the left panel, select **Settings**, and go to the **Integrations** tab.
3. Find the Jira card and click the **'Connect'** button.<br>

   <figure><img src="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2FDf8O2UDB1JIFroGQjyf1%2Fimage.png?alt=media&amp;token=02a31a9e-e5f3-49c6-8d53-49d2b1e46f1a" alt="" width="270"><figcaption></figcaption></figure>
4. In the pop-up, paste the link of your Jira domain and press "Enter" key. A link to Jira application page will be generated. Click on the link.<br>

   <figure><img src="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2F3pt2idXkj8V5tRXMo2Ph%2Fimage.png?alt=media&amp;token=73b0e2a0-0cff-437c-a1a4-604fed42b8c9" alt="" width="563"><figcaption></figcaption></figure>
5. You'll be redirected to your Jira account. Click on **Create Link.**
6. Select **Direct Application Link** and paste our application's link - [<mark style="color:purple;">https://app.hivel.ai</mark>](https://app.hivel.ai/dashboard/cto). Click on continue.<br>

   <figure><img src="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2FIchDsFQAUqPThzOScS5b%2Fimage.png?alt=media&amp;token=f63f0fa6-e496-4018-937d-30a0884fdda3" alt="" width="375"><figcaption></figcaption></figure>
7. Copy the **Application Name** from Hivel's integration page and paste in the recent pop-up in Jira. Select **Application Type** as "Generic Application". Click on continue.<br>

   <figure><img src="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2FKtQr7pDrojLvcSLd8ZNJ%2Fimage.png?alt=media&amp;token=426e32bf-6f97-49bb-9184-45859797ffa2" alt="" width="563"><figcaption><p><em>From Hivel's integration page</em></p></figcaption></figure>

   <figure><img src="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2F7w6tf9QHwfAJXPABnBe2%2Fimage.png?alt=media&amp;token=cf768d90-4c3b-4527-84fc-2b34f1185d69" alt="" width="311"><figcaption><p><em>Jira pop-up</em></p></figcaption></figure>
8. A new entry will be added in the Jira Application Link page. Click on the 3 dots in the new entry and select Configure.
9. Go to **Incoming Authentication.**<br>

   <figure><img src="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2Fr5nxvIffcbujOeJ6hmF6%2Fimage.png?alt=media&amp;token=4df9488d-d269-44ff-9413-f6c32ed8f620" alt="" width="563"><figcaption></figcaption></figure>
10. Copy the **Consumer Key**, **Consumer Name**, **Public Key**, and **Redirection Link** from Hivel integration page and paste in the Incoming Authentication tab in Jira. Then, hit “Save”.

    <figure><img src="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2FrEIojpX1k7VAzrX7uFVk%2Fimage.png?alt=media&amp;token=876b9329-166d-462c-8ed6-7bba936fea05" alt="" width="375"><figcaption></figcaption></figure>
11. Go back to the Hivel's integration page and click on **Submit.** In case an error pops up, please repeat the above processes again.\
    If everything is set up correctly, it will get connected.
12. The next step is to **create a webhook** for ongoing data, and for that
    1. Open a new tab and log in to your Jira application using the same admin credentials
    2. Top Right corner-> **Settings** -> **System**
    3. On the Left panel -> **Webhooks**
    4. Top Right -> **Create webhook**
    5. Now use the below details in the form:
       1. **Name:** Hivel
       2. **URL**- [<mark style="color:purple;">https://app.hivel.ai/jiraapi/webhook/process</mark>](https://app.insightly.ai/jiraapi/webhook/process)​
       3. **Events:**
          1. *Issue related events*
             1. **JQL: All issues**
             2. **Issue** (select checkboxes) : created, updated, deleted
          2. *User related events*
             1. **User** (select checkboxes) : created, deleted, updated
          3. *Jira Software related events*
             1. **Sprint** (select checkboxes)**:** deleted, updated, started, closed
    6. Ensure Name, URL, and events are all checked. Click on **Create.**

Done! Data will be refreshed within 24 hours.

{% hint style="info" %}
***Note:*** Make sure to connect Jira with the **admin account**.
{% endhint %}

For any issues or assistance, feel free to reach us at [<mark style="color:purple;">support@hivel.ai</mark>](mailto:support@hivel.ai).