---
title: "Azure DevOps Integration"
canonical: "https://support.appfire.com/space/EIFJC/10125446/Azure%20DevOps%20Integration"
format: markdown
---
> Macro (aura-html)

This example demonstrates how to use Easy Integrations to create an Azure DevOps work item when a Jira issue is created.

## Prerequisites

Before you begin the configuration, ensure you have the following prerequisites in place:

- Ensure you have admin privileges to your Jira instance.
- Ensure you have access to your Azure DevOps organization or project and have the necessary permissions to create Personal Access Tokens (PATs).

## Configuration

Follow these steps to set up the integration between Jira and Azure DevOps using Easy Integrations:

### **Step 1:** Create an Azure DevOps PAT

1. <span style="color: #333333">Open your Azure DevOps profile.</span>
2. <span style="color: #333333">Create a PAT with the maximum expiration date. Make sure to note the token for later use.</span>

### **Step 2:** Configure Jira Credentials

3. Navigate to **Apps** in the Jira top menu and select **Manage your apps**.
4. From the sidebar, navigate to **Easy Integrations configuration**.
5. Click on the **Credentials** app menu item.
6. Add a new Basic Authorization credential with the PAT information.

### Step 3: Configure a Listener

7. In Jira, access **Easy Integrations configuration**.
8. Under **Listeners**, add a new Listener with the following details:

| **Field** | **Description** | ** Example value** |
| --- | --- | --- |
| Listener name | Give a name to track | Azure DevOps Integration |
| Listener is enabled | Works only when enabled | Checked |
| Retry attempt count | When something went wrong, number of retry count | 3 |
| Events | Only one event is enough for the example | JQL can be different, this example listens only to the Bug issues.<br>> Macro (nested-table) |
| Condition | Pre-condition of the listener. | Checked |
| Condition script | Let's process issues those only have description starting with *Good* | `return lodash.startsWith(data.event.issue.fields.summary, 'Good');` |
| Action 1 | Add a new "Call a Rest API" action | > Macro (nested-table) |
| Action 2 | Add a new "Update a Jira issue" action | > Macro (nested-table) |

9. Click **Save** and then **Submit** to save your configuration.

### **Step 4:** Create a Jira Bug Issue

10. Create a Jira bug issue. If everything is configured correctly, a new Azure DevOps work item should be automatically created, and all operations will be logged in the Execution Logs.

### **Step 5 (Extra):** Audit Log

The audit log will display the created Listener configuration logs, and any future updates to the integration will be logged as well.

## Example screenshots

### Listener screen:

![image](media://3e98072d-307f-4b4a-849a-747830c25860)

### First Action:

![image](media://0d8cec6f-8267-4ee1-86a1-d79afb8989f6)

### Second Action:

![image](media://612149ae-a1a2-4803-8bd3-e48c05ebae20)

### Execution Logs:

![image](media://9f78849d-d817-4f65-a58b-c6b92a430443)