# Create an Azure DevOps Work item when a Bolt run complete with errors

## Introduction

This guide will show you how to set up an integration between Paradime and [Azure DevOps](https://azure.microsoft.com/en-gb/products/devops) using [Paradime Webhooks](broken://pages/jE6wQwTKjLY0SYewn9xV) 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](/app-help/documentation/bolt/creating-schedules.md)
* Paradime [Webhooks](broken://pages/jE6wQwTKjLY0SYewn9xV) enabled
* An [Azure DevOps](https://azure.microsoft.com/en-gb/products/devops) 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.

<figure><img src="/files/aI1RiJu2ApeADSU0H7Zx" alt=""><figcaption></figcaption></figure>

## 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.

<figure><img src="/files/SidFiepjEwsFgPDNmhJh" alt=""><figcaption></figcaption></figure>

{% hint style="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.
  {% endhint %}

## 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.

<figure><img src="/files/nHiKvj3NxglAgU7JGIAb" alt=""><figcaption></figcaption></figure>

## Configure Azure DevOps action

Finally add another step to your Zap and select the Azure DevOps action. From the menu, select the event **Create Work Item** and click on **Continue**.

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

Here you will be able to template the Title and Description of the Azure DevOps Work item using any of the available metadata fields from the [Paradime Webhook JSON](broken://pages/jE6wQwTKjLY0SYewn9xV#examples-of-json-payloads) payload.

<figure><img src="/files/tc4xrTn34phjwW8f2koN" alt=""><figcaption></figcaption></figure>

## 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 Azure DevOps Work item will be created :raised\_hands:.

<figure><img src="/files/Ocfcjf6x3VtycqjB6VUe" alt=""><figcaption></figcaption></figure>


---

# 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.paradime.io/app-help/developers/webhooks/custom-webhook-guides/azure-devops.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.
