Source: https://sprinto-test.docs-staging.pageloop.ai/ingestion/configure-azure-devops-integration

# Configure Azure DevOps Integration

The Azure DevOps Incidents ingestion plan allows Sprinto to automatically ingest and monitor incident data from your Azure DevOps environment. Once configured, Sprinto syncs incident records from selected Azure DevOps projects and surfaces them under the Incidents module in the Data Library.

You can authenticate the integration using either:

- Azure DevOps credentials
- A Personal Access Token (PAT)

After authentication, you must configure the projects that Sprinto should monitor.

### Prerequisites

Before configuring the integration, ensure that:

- You have administrator access to Azure DevOps.
- You have access to the Azure DevOps organisation you want to connect.
- You have the required project permissions to access incidents and work items.
- If you are using a Personal Access Token, ensure that the token has the required read permissions.

### Configure the Azure DevOps Incidents ingestion plan

1. Log in to the Sprinto dashboard.
2. Go to **Ingestion**.
3. Open the **Plans** tab.
4. Click **New Plan**.

![](/assets/5f73196b17c7-screenshot-2026-05-15-at-15.56.09.png)

5. Click **New Plan**.
6. Select **From Template**.

![](/assets/d64756eca0be-screenshot-2026-05-15-at-15.56.58.png)

7. Click **Preview** next to **Azure DevOps Incidents**.

![](/assets/6e08db820477-screenshot-2026-05-15-at-15.57.56.png)

5. Click **View** to open the template.
6. Click **Connect to Azure DevOps (Incidents)** connection.

![](/assets/a32124260474-screenshot-2026-05-21-at-11.47.55.png)

You can now choose one of the following authentication methods:

- My credentials
- Personal access token

![](/assets/087b7e42e1a1-screenshot-2026-05-21-at-11.48.48.png)

---

## Authenticate using Azure DevOps credentials

1. In the authentication window, select **My credentials (recommended)**.
2. Click **I am an admin**.
3. Review the required permissions.
4. Click **Next**.

![](/assets/e44d60740c75-screenshot-2026-05-21-at-11.51.28.png)

5. Enter your **organization name**.

![](/assets/26e704ca5580-screenshot-2026-05-21-at-11.53.00.png)

6. Click **Open Window**.
7. Sign in to your Micorsoft account and follow the on-screen instructions.
8. Complete the authentication flow.

---

## Authenticate using a Personal Access Token

You need to generate a personal access token for this. To do that:

### Generate a Personal Access Token

To learn how to generate a Personal Access Token in Azure DevOps, refer to the official Microsoft documentation:

[Create a Personal Access Token in Azure DevOps](https://learn.microsoft.com/en-us/azure/devops/organizations/accounts/use-personal-access-tokens-to-authenticate?utm_source=chatgpt.com)

After the credentials are attached successfully:

1. Wait approximately 45 minutes for the initial sync to complete.
2. Return to the ingestion plan.
3. Click **Refresh**.

![](/assets/0e74c5d74daa-screenshot-2026-05-21-at-12.02.37.png)

Proceed to the next section to configure monitored projects.

### Required permissions for Personal Access Token authentication

The Personal Access Token must include the following read permissions:

| Permission                    | Access level | Purpose                                            |
| ----------------------------- | ------------ | -------------------------------------------------- |
| Work Items                    | Read         | Required for ticket sync and changelog passthrough |
| Project and Team              | Read         | Required for collections sync                      |
| Identity                      | Read         | Required for user sync                             |
| Member Entitlement Management | Read         | Required for user roster enumeration               |

Ensure that all required permissions are enabled before generating the Personal Access Token.

After that, return to Sprinto:

1. In the authentication window, select **Personal access token**.

![](/assets/623bbfe13da0-screenshot-2026-05-21-at-11.54.58.png)

2. On the administrator access screen, click **I am an admin**.
3. Review the required read access permissions.
4. Click **Next**.

![](/assets/e44d60740c75-screenshot-2026-05-21-at-11.51.28.png)

5. Enter your Azure DevOps username.
6. Enter your password.
7. Click **Next**.

![](/assets/74b47d32adbc-screenshot-2026-05-21-at-11.56.38.png)

8. Enter your Azure DevOps organisation name.
9. Click **Next**.

![](/assets/a40cc25b45e0-screenshot-2026-05-21-at-12.01.55.png)

Sprinto begins setting up the account and attaching the credentials.

---

## Configure projects for monitoring (Incidents)

After the initial sync completes:

1. Navigate to **Data Library > Incidents**.
2. Open the **Azure DevOps** tab.
3. Click **Manage Azure DevOps** in the top-right corner.

![](/assets/18b42bd87a05-screenshot-2026-05-21-at-12.03.08.png)

The configuration drawer displays all available Azure DevOps projects.

### Configure monitored projects

For each project:

1. Select or deselect the project checkbox.
2. Configure the closure statuses.
3. Enter the work item type.
4. Click **Save**.

![](/assets/114292ec5e56-screenshot-2026-05-21-at-12.04.02.png)

> [!WARNING]
>
> #### Important
>
> - The **Work Item Type** field is case sensitive.
> - Ensure that the value exactly matches the work item type configured in Azure DevOps.

After saving the project configuration:

1. Navigate back to **Ingestion > Ingestion Plans**.
2. Open the **Azure DevOps Incidents** ingestion plan.
3. Click **Refresh** again.

![](/assets/b684a46fe5bc-screenshot-2026-05-21-at-12.05.44.png)

The integration setup is now complete.

### What happens after configuration?

Once configured, Sprinto:

- Syncs incidents from the selected Azure DevOps projects
- Tracks incident statuses and updates
- Maps configured work item types
- Displays incident records under the Azure DevOps tab in the Incidents module

## Configure projects for monitoring (Change Management)

Use the Azure DevOps Change Management integration to monitor ticket approvals and change workflows within Sprinto.

---

### Configure Azure DevOps Change Management

1. Log in to the Sprinto dashboard.
2. Navigate to **Data Library** > **Change management**.
3. In the **Change management systems** tab, select **Ticketing providers**.
4. Click **Add system**.

![](/assets/6554152b41df-screenshot-2026-05-21-at-2.12.47-pm.png)

5. In the drawer that opens, locate **Azure DevOps Change Management**.
6. Click **Add** next to the integration template.

![](/assets/00b0ac8b112e-screenshot-2026-05-21-at-2.13.04-pm.png)

---

### Step 1: Filter tickets to monitor

Configure the Azure DevOps tickets Sprinto should continuously import and monitor.

1. Under **Azure DevOps Change Management Project**, select the project you want to monitor.
2. Under **Advanced filters**, configure the following fields:

| Field                                               | Description                                                                                 |
| --------------------------------------------------- | ------------------------------------------------------------------------------------------- |
| **Issue type**                                      | Specify the work item type to monitor. This field is case-sensitive.                        |
| **Ticket status that indicates the change is done** | Specify the ticket status that represents a completed change. This field is case-sensitive. |

3. Under **Change type**, provide details about the type of changes represented by these tickets.
4. Click **Next**.

![](/assets/8aae7a3b9424-screenshot-2026-05-21-at-2.14.32-pm.png)

---

### Step 2: Configure approvals to monitor

Configure the approval states Sprinto should validate before considering a change approved.

1. Under **Approval State 1**, configure:
   - **Ticket state that indicates change is approved**
   - **Who can assign that state**
2. To configure additional approval stages, click **Add another approval state to monitor**.
3. Under **Applicable from**, select the date from which Sprinto should evaluate approval workflows.
4. Under **System Owner**, select the owner responsible for approval-related checks.
5. Click **Finish**.

![](/assets/8819e71a931f-screenshot-2026-05-21-at-2.14.49-pm.png)

---

### Verify the integration

1. Navigate back to **Data Library** > **Change management**.
2. Open the **Ticketing providers** tab.
3. Verify that the Azure DevOps Change Management project appears in the list.
4. Click **View details** to review the configured integration.

![](/assets/b88bf5955389-screenshot-2026-05-21-at-2.15.13-pm.png)

### Troubleshoot sync issues

If incidents do not appear after setup:

- Verify that the credentials are active.
- Ensure that the correct projects are selected.
- Confirm that the closure statuses are configured correctly.
- Verify that the work item type matches Azure DevOps exactly.
- Wait for the sync interval to complete and click **Refresh** again.

If the issue persists, contact [Sprinto Support](mailto:support@sprinto.com).