> ## 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 Linear Issue when a Bolt run complete with errors

> Paradime Linear Integration: Automatically create Linear issues for dbt™ project errors. For better issue tracking and resolution.

## Introduction

This guide will show you how to set up an integration between Paradime and [Linear](https://linear.app/) using Paradime Webhooks and [Zapier](https://zapier.com/).

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

### Prerequisites&#x20;

For this integration, make sure you have the following:

* A Paradime [Bolt schedule configured](/products/bolt/creating-schedules/index)
* Paradime Webhooks enabled
* A [Linear](https://linear.app/)  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 Linear action

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

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

Here you will be able to template the Title and Description of the Linear 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-17.40.02.png?fit=max&auto=format&n=F1X35JoCsYMKtOFi&q=85&s=10f73d6dc5a1cedceee57949933eea8b" alt="" width="1150" height="749" data-path="images/Screenshot-2024-03-11-at-17.40.02.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 Linear Issue will be created :raised\_hands:.

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


## Related topics

- [Create a Jira Issue when a Bolt run complete with errors](/developers/webhooks/custom-webhook-guides/jira-issue.md)
- [Create an Azure DevOps Work item when a Bolt run complete with errors](/developers/webhooks/custom-webhook-guides/azure-devops.md)
- [Custom Webhook Guides](/developers/webhooks/custom-webhook-guides/index.md)
- [Create Linear Issues](/products/bolt/creating-schedules/templates/ticketing-templates/create-linear-issues.md)
- [Linear Tool](/products/dino-ai/tools-and-features/linear-tool.md)
