> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paradime.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a Jira Issue when a Bolt run complete with errors

> Paradime's Jira Integration: Generate Jira issues automatically for dbt™ project errors. For more efficient issue tracking and management.

## Introduction

This guide will show you how to set up an integration between Paradime and [Jira](https://www.atlassian.com/software/jira?\&aceid=\&adposition=\&adgroup=144591217916\&campaign=19313277976\&creative=642044761145\&device=c\&keyword=jira\&matchtype=e\&network=g\&placement=\&ds_kids=p74602868222\&ds_e=GOOGLE\&ds_eid=700000001558501\&ds_e1=GOOGLE\&gad_source=1\&gclid=CjwKCAjw17qvBhBrEiwA1rU9w0FxfE1zm86_W1gDbh4ub5A4CkZKAVUbjM7cnMljl66r3zcFfKrL8BoCE4wQAvD_BwE\&gclsrc=aw.ds) using Paradime Webhooks and [Zapier](https://zapier.com/).

At the end of this tutorial, you will be able to create a Jira Issue every time a Bolt schedule fails including details of the Bolt schedule.

### Prerequisites 

For this integration, make sure you have the following:

* A Paradime [Bolt schedule configured](/products/bolt/creating-schedules/index)
* Paradime Webhooks enabled
* A [Jira](https://www.atlassian.com/software/jira?\&aceid=\&adposition=\&adgroup=144591217916\&campaign=19313277976\&creative=642044761145\&device=c\&keyword=jira\&matchtype=e\&network=g\&placement=\&ds_kids=p74602868222\&ds_e=GOOGLE\&ds_eid=700000001558501\&ds_e1=GOOGLE\&gad_source=1\&gclid=CjwKCAjw17qvBhBrEiwA1rU9w0FxfE1zm86_W1gDbh4ub5A4CkZKAVUbjM7cnMljl66r3zcFfKrL8BoCE4wQAvD_BwE\&gclsrc=aw.ds) account
* A [Zapier](https://zapier.com) account

## Create a new Zap in Zapier

To trigger an action each time a webhook event is delivered in Zapier, create a new Zap with **Webhooks by Zapier** as the Trigger and **Catch Hook** as the Event.

Press **Continue**, and copy the webhook URL. You will need this to connect Zapier to Paradime.

<Frame>
  <img src="https://mintcdn.com/paradime-docs/F1X35JoCsYMKtOFi/images/Screenshot-2024-03-11-at-17.00.26.png?fit=max&auto=format&n=F1X35JoCsYMKtOFi&q=85&s=c39c272bd05fcfdf5c207d93f2d96ee0" alt="" width="1142" height="742" data-path="images/Screenshot-2024-03-11-at-17.00.26.png" />
</Frame>

## Configure a new Webhook in Paradime

In Paradime navigate to Account Settings and select Webhooks from the left Panel. Now you can click on `+ Add Endpoint` to configure your webhook.

* Enter the webhook URL generated by Zapier in the previews step
* Add a description for your webhook integration (optional)
* Filter to include in the event only the `bolt.run.`**`completed`** event

When done, click on `Create`  to setup the webhook.&#x20;

<Frame>
  <img src="https://mintcdn.com/paradime-docs/F1X35JoCsYMKtOFi/images/Screenshot-2024-03-11-at-17.07.11.png?fit=max&auto=format&n=F1X35JoCsYMKtOFi&q=85&s=ad5de63d73b0617ba6c0665993ae20a7" alt="" width="1195" height="801" data-path="images/Screenshot-2024-03-11-at-17.07.11.png" />
</Frame>

<Info>
  Now that the integration is configured, to help with the next steps:

  * Trigger a Bolt Run
  * When the Bolt Run is completed, in Zapier, click on test trigger to receive a Bolt event which can be used to setup and test the Zapier action.
</Info>

## Configure a Zapier filter

Now let's filter the webhook events for Bolt schedule completed with status: `error` or `failed`. This will ensure that Linear Issues only for Bolt schedules completed with errors.

Add a **Only continue if...** step in Zapier, choose the **Status** field from the webhook response and filter for the condition to filer when status exactly match `error` or `failed`.

Click **Continue**. If the example Bolt run for your Zap setup matches any of the mentioned states, a confirmation message will display, indicating the Zap will proceed.

<Frame>
  <img src="https://mintcdn.com/paradime-docs/F1X35JoCsYMKtOFi/images/Screenshot-2024-03-11-at-17.25.07.png?fit=max&auto=format&n=F1X35JoCsYMKtOFi&q=85&s=ab0c14cacac716005b72f8c5a5489526" alt="" width="1142" height="745" data-path="images/Screenshot-2024-03-11-at-17.25.07.png" />
</Frame>

## Configure Jira action

Finally add another step to your Zap and select the Jira action. From the menu, select the event **Create Issue** and click on **Continue**.&#x20;

You will now need to authenticate to your Jira account and establish a connect. When completed you can setup the action to create a Jira Issue using Bolt Webhook events when a run completed with errors.

Here you will be able to template the Title and Description of the Jira Issue using any of the available metadata fields from the Paradime Webhook JSON payload.&#x20;

<Frame>
  <img src="https://mintcdn.com/paradime-docs/F1X35JoCsYMKtOFi/images/Screenshot-2024-03-11-at-20.08.38.png?fit=max&auto=format&n=F1X35JoCsYMKtOFi&q=85&s=0d69c3cf81d9981e1ffadbabcfc911f2" alt="" width="1152" height="750" data-path="images/Screenshot-2024-03-11-at-20.08.38.png" />
</Frame>

## Test and deploy your Zap

When done, you can click on **Continue** and Test your Zap, and finally click on the **Publish** button to go live. Each time a Bolt run will complete with errors, a new Jira Issue will be created :raised\_hands:.

<Frame>
  <img src="https://mintcdn.com/paradime-docs/F1X35JoCsYMKtOFi/images/Screenshot-2024-03-11-at-20.11.16.png?fit=max&auto=format&n=F1X35JoCsYMKtOFi&q=85&s=d69b029d314c22932a701ffc52a53cc6" alt="" width="1202" height="798" data-path="images/Screenshot-2024-03-11-at-20.11.16.png" />
</Frame>


## Related topics

- [Create an Azure DevOps Work item when a Bolt run complete with errors](/developers/webhooks/custom-webhook-guides/azure-devops.md)
- [Create a Linear Issue when a Bolt run complete with errors](/developers/webhooks/custom-webhook-guides/linear-issue.md)
- [Custom Webhook Guides](/developers/webhooks/custom-webhook-guides/index.md)
- [Create Jira Tickets](/products/bolt/creating-schedules/templates/ticketing-templates/create-jira-tickets.md)
- [jira-backlog-agent](/guides/programmable-agents/jira-backlog-agent.md)