Configure Azure DevOps Integration

Configure the Azure DevOps Incidents ingestion plan in Sprinto to sync incidents, map projects, and monitor work items automatically.

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.

1. Click New Plan.

2. Select From Template.

1. Click Preview next to Azure DevOps Incidents.

1. Click View to open the template.

2. Click Connect to Azure DevOps (Incidents) connection.

You can now choose one of the following authentication methods:

• My credentials

• Personal access token

---

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.

1. Enter your organization name.

1. Click Open Window.

2. Sign in to your Micorsoft account and follow the on-screen instructions.

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

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.

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.

1. On the administrator access screen, click I am an admin.

2. Review the required read access permissions.

3. Click Next.

1. Enter your Azure DevOps username.

2. Enter your password.

3. Click Next.

1. Enter your Azure DevOps organisation name.

2. Click Next.

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.

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.

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.

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.

1. In the drawer that opens, locate Azure DevOps Change Management.

2. Click Add next to the integration template.

---

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.

1. Under Change type, provide details about the type of changes represented by these tickets.

2. Click Next.

---

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.

---

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.

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.