# Create Azure DevOps Items

Learn how to automatically create Azure DevOps work items when dbt™ runs fail in Bolt. This integration helps data teams track and respond to pipeline failures efficiently by connecting Bolt's pipeline monitoring with Azure DevOps' work item management system.

### What You'll Get

When a run fails, Bolt automatically creates an Azure DevOps work item containing:

* Issue title with schedule name
* Description including:
  * Link to Paradime run logs
  * Run details: Run ID, Start and end time, Commands executed, Branch information, etc. 

<figure><img src="https://2337193041-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHET0AD04uHMgdeLAjptq%2Fuploads%2Fau4DETfFOcGlcSmduzyo%2Fimage.png?alt=media&#x26;token=44e67d4b-3251-4261-9704-8fa7c38ba5dd" alt=""><figcaption></figcaption></figure>

{% hint style="success" %}

#### Key Benefits for Data Teams

* Automatic work item creation when dbt™ pipelines fail
* Real-time pipeline monitoring in Azure DevOps
* Streamlined workflow between dbt™ runs and Azure DevOps
* Faster response time to pipeline failures
  {% endhint %}

{% hint style="warning" %}

#### Prerequisites for Azure Devops Integration

* Existing [Bolt schedule](https://app.paradime.io/bolt)
* Admin access to [Azure DevOps](https://azure.microsoft.com/en-gb/products/devops) and access to: Organization Name, Project Name, and Personal Access Token (PAT)
  {% endhint %}

***

### Getting Started

Set up Azure DevOps work item creation for failed runs. Follow the steps below, and watch our interactive tutorial.

#### Step 1: Gather Your Azure DevOps Information

1. **Get Organization and Project Names**:
   * Open your Azure DevOps project
   * From the URL `https://dev.azure.com/YOUR-ORG-NAME/YOUR-PROJECT-NAME`:
     * Copy your organization name (`YOUR-ORG-NAME`)
     * Copy your project name (`YOUR-PROJECT-NAME`)
2. **Get Organization and Project Names**:
   * In Azure DevOps, go to **User Settings** and select **Personal Access Tokens**
   * Create a new token with work item permissions
   * Save this token securely

{% hint style="info" %}
Need help generating Access Tokens? Follow [Azure Devops official documentation](https://learn.microsoft.com/en-us/azure/devops/organizations/accounts/use-personal-access-tokens-to-authenticate?view=azure-devops\&tabs=Windows).&#x20;
{% endhint %}

<figure><img src="https://2337193041-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHET0AD04uHMgdeLAjptq%2Fuploads%2FnTMUqEdDgsHISqFLwxgA%2Fimage.png?alt=media&#x26;token=643ae040-96b3-4d68-97cf-55afc91f9d28" alt=""><figcaption></figcaption></figure>

### Step 2: Configure the Webhook

1. From the [Bolt](https://app.paradime.io/bolt) home screen, go to [Templates](https://app.paradime.io/bolt/templates)&#x20;
2. Click **Ticketing** and use the **Create Azure DevOps Work Item** template
3. Enter your Azure DevOps credentials:
   * Organization Name
   * Project Name
   * PAT Token
4. Click "Connect"

<figure><img src="https://2337193041-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FHET0AD04uHMgdeLAjptq%2Fuploads%2Fn7VmDOiZfAqOgmaTi1NG%2Fimage.png?alt=media&#x26;token=82161458-8005-4e6d-80bf-2d246e467bd8" alt=""><figcaption></figcaption></figure>

#### Step 3: Test the Integration

1. [Run a Bolt schedule manually](https://docs.paradime.io/app-help/documentation/managing-schedules/schedule-configurations#trigger-a-run-manually) (the webhook triggers only on failed runs)
2. After the run fails, check your Azure DevOps project for the new work item
3. Verify the work item contains run failure details

{% @arcade/embed flowId="xbSZRBsK1bb1UyLLYtvP" url="<https://app.arcade.software/share/xbSZRBsK1bb1UyLLYtvP>" %}