# Jira Cloud Alert Source

Follow the steps below to configure a service so as to push related alert data from Jira onto Squadcast.

Squadcast will then process this information to create incidents for this service as per your preferences.

{% hint style="info" %}
**Pre-requisites**

1. A valid Squadcast cloud / On-Premise subscription
2. A user account in JIRA Cloud with Administrator privileges
   {% endhint %}

### Using Jira as an Alert Source in Squadcast

1. Navigate to **Services** -> **Service Overview** -> select or search for your Service. Expand the accordion -> In the Alert Sources section, click **Add**.

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-4fbd74e7ca0b30173c47a1d58ed6a0804a0465aa%2FAlert_Sources.png?alt=media\&token=aaca6610-9d18-4dd4-9cf5-320042f326f1)

2\. Select **Jira Cloud**. Copy the displayed **Webhook URL** to [configure](#create-a-squadcast-webhook-in-jira-cloud) it within **Jira Cloud.** Finish by clicking **Add Alert Source** -> **Done.**

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-ad29f46866e2e8897dcf658af30e0ce1597429cc%2FJira%20Cloud.png?alt=media)

{% hint style="warning" %}
**Important:**

When an alert source turns Active, it’ll show up under Configured Alert Sources, you can either generate a test alert from the integration or wait for a real-time alert to be generated by the Alert Source. An Alert Source is active if there is a recorded incident via that Alert Source for the Service.
{% endhint %}

### Create a Squadcast Webhook in Jira Cloud

1. Login to Jira Cloud and go to **Settings** in left-side pannel.

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-77377518b52e2a0fd772a01e06a8309621519db9%2Fjira_cloud_2.png?alt=media)

2.Go to **System** under **Jira Settings**

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-6de4e9783f3c4b8587fdc8dd7b60b6a0995c677a%2Fjira_cloud_3.png?alt=media)

3.Click on the **WebHook** tab under the **Advanced** Section.

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-35c0b6ddbc4ccf5f7c78367fc4f19253c8ec5bd8%2Fjira_cloud_4.png?alt=media)

4.Click on **Create a Webhook**.

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-c17a1c0be25813abe77ba203595e80064e18c76c%2Fjira_cloud_5.png?alt=media)

5\. Paste the **Jira Cloud Webhook URL** copied from Squadcast Dashboard in the **URL** field and check the **created** And **updated** check boxes under issues. Click on **Create** to finally save the webhook.

![](https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-fd3274f5a7ea7c0bcbe8817db474ea8c1dff284a%2Fjira_cloud_6.png?alt=media)

{% hint style="warning" %}
**Important:**

\
If you are using both Jira as an alert source and Jira Cloud extension, sometimes it might cause duplicate ticket/incident loops depending on your configuration. In order to prevent that, please add this condition <mark style="color:red;">`reporter.displayName != "Squadcast"`</mark> to your JQL query configuration under your Jira Webhook configuration for Squadcast alert source.

<img src="https://1574591692-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F8TaWz01jmUJl58p4ZVel%2Fuploads%2Fgit-blob-e075302268403e8b633ebed2009fd13b317d5553%2Fjira_alert_source_and_extension.png?alt=media" alt="" data-size="original">
{% endhint %}

{% hint style="info" %}
**Note**

Enable only the highlighted **Issue related events** as shown in the screenshot above. Squadcast will ignore any other Issue event type.
{% endhint %}

Now whenever an issue goes to status-category with key **new** in Jira, an incident will be triggered in Squadcast. Also when that issue goes to status-category with key **done** in Jira, it will be resolved in Squadcast.

*Have any questions?* [*Ask the community*](https://community.squadcast.com/view/home)*.*
