> ## Documentation Index
> Fetch the complete documentation index at: https://docs.incident.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Azure DevOps

> Keep incidents and their follow-ups tracked in Azure DevOps, without anyone updating them by hand.

Connect Azure DevOps to create work items in the project your team already plans in: one for each incident, and one for each follow-up you export. We keep them updated as the work progresses, and sync changes back.

## Connecting Azure DevOps

Sign in as an Azure DevOps user with access to the relevant projects, then go to [Settings → Integrations](https://app.incident.io/~/settings/integrations), find Azure DevOps, and click **Connect**.

Click **Sign in with Microsoft** and complete the authorization flow.

<img src="https://mintcdn.com/incidentio-18bb4170/YyaXj7lNF5_8OSsE/images/integrations/azure-devops/azure-connect.png?fit=max&auto=format&n=YyaXj7lNF5_8OSsE&q=85&s=d18d2aebdc53f896fd3dd2dfa86d6270" alt="Connecting the Azure DevOps integration from the incident.io dashboard" width="1054" height="670" data-path="images/integrations/azure-devops/azure-connect.png" />

<Info>
  Use a personal account under a shared "service" email. Azure service accounts behave differently in the API, so we don't support them for authentication.
</Info>

Then add a [service hook](#service-hooks) so changes in Azure DevOps reach us.

## Exporting follow-ups

Export [follow-ups](/post-incident/follow-ups) as Azure DevOps work items, from the dashboard or from Slack and Microsoft Teams. Use an [export template](/integrations/auto-export-follow-ups) to send them automatically based on incident attributes.

The title always comes from the follow-up, and can't be set in a template. The work item's title syncs back as the follow-up title instead.

Changes in Azure DevOps update the linked follow-up:

* Title, description, and tags, which become follow-up labels
* The assignee, which becomes the follow-up owner
* Completion, which completes the follow-up and records when it happened

A work item counts as complete once it has a completed date. Which field that is depends on your process template: **Completed Date** on Scrum, **Resolved Date** on Agile, or **Closed Date** on Basic. We use whichever is set.

## Incident tickets

Set up [incident tickets](/integrations/incident-tickets) to create and maintain a work item for each incident, with its title, description and state driven by a template. Templates default to the **Issue** work item type.

Comments added to the work item sync back into incident.io.

## Service hooks

A service hook lets changes in Azure DevOps reach incident.io. Without one, nothing syncs back for follow-ups or incident tickets.

1. Go to your project, select **Project settings**, and then select **Service hooks**.

<img src="https://mintcdn.com/incidentio-18bb4170/TBdaveUAr1Q7-4Y5/images/help-centre/syncing-incidents-to-azure-devops/screenshot-2.png?fit=max&auto=format&n=TBdaveUAr1Q7-4Y5&q=85&s=d81558e3198542e9c6d2bb2e104ef78c" alt="Finding service hooks under Azure DevOps project settings" width="1054" height="670" data-path="images/help-centre/syncing-incidents-to-azure-devops/screenshot-2.png" />

2. Select **Create subscription**.

<img src="https://mintcdn.com/incidentio-18bb4170/TBdaveUAr1Q7-4Y5/images/help-centre/syncing-incidents-to-azure-devops/screenshot-3.png?fit=max&auto=format&n=TBdaveUAr1Q7-4Y5&q=85&s=f4545c4e3c7d30ae87a1c696d22ed143" alt="The create subscription button in Azure DevOps service hooks" width="1002" height="1508" data-path="images/help-centre/syncing-incidents-to-azure-devops/screenshot-3.png" />

3. Select **Web Hooks** and then click **Next**.

<img src="https://mintcdn.com/incidentio-18bb4170/TBdaveUAr1Q7-4Y5/images/help-centre/syncing-incidents-to-azure-devops/screenshot-4.png?fit=max&auto=format&n=TBdaveUAr1Q7-4Y5&q=85&s=e4fa77a21045c3ce188beded4236d76a" alt="Choosing Web Hooks as the service hook type" width="1384" height="542" data-path="images/help-centre/syncing-incidents-to-azure-devops/screenshot-4.png" />

4. Change the trigger to **Work item updated** and then click **Next**.

<img src="https://mintcdn.com/incidentio-18bb4170/TBdaveUAr1Q7-4Y5/images/help-centre/syncing-incidents-to-azure-devops/screenshot-5.png?fit=max&auto=format&n=TBdaveUAr1Q7-4Y5&q=85&s=c8f0b3a019ef3c5565ce41fdcaa2bb7b" alt="Setting the service hook trigger to work item updated" width="1200" height="1204" data-path="images/help-centre/syncing-incidents-to-azure-devops/screenshot-5.png" />

5. Copy the service hook details from the dashboard into the service hook config.

<img src="https://mintcdn.com/incidentio-18bb4170/TBdaveUAr1Q7-4Y5/images/help-centre/syncing-incidents-to-azure-devops/screenshot-6.png?fit=max&auto=format&n=TBdaveUAr1Q7-4Y5&q=85&s=92cf9e763671a3c354bb9e043f5568d7" alt="The service hook details shown in the incident.io dashboard" width="1208" height="1212" data-path="images/help-centre/syncing-incidents-to-azure-devops/screenshot-6.png" />

<img src="https://mintcdn.com/incidentio-18bb4170/TBdaveUAr1Q7-4Y5/images/help-centre/syncing-incidents-to-azure-devops/screenshot-7.png?fit=max&auto=format&n=TBdaveUAr1Q7-4Y5&q=85&s=530f8e83aa556a11f2e5b8180a216618" alt="Pasting the service hook details into Azure DevOps" width="1378" height="1496" data-path="images/help-centre/syncing-incidents-to-azure-devops/screenshot-7.png" />

6. Click **Test**, and check the dashboard shows a success.

<img src="https://mintcdn.com/incidentio-18bb4170/TBdaveUAr1Q7-4Y5/images/help-centre/syncing-incidents-to-azure-devops/screenshot-8.png?fit=max&auto=format&n=TBdaveUAr1Q7-4Y5&q=85&s=9a09f9a7008151b28f2f119255008661" alt="A successful service hook test" width="1204" height="1214" data-path="images/help-centre/syncing-incidents-to-azure-devops/screenshot-8.png" />

7. Click **Finish** in Azure DevOps to complete the setup.

<img src="https://mintcdn.com/incidentio-18bb4170/TBdaveUAr1Q7-4Y5/images/help-centre/syncing-incidents-to-azure-devops/screenshot-9.png?fit=max&auto=format&n=TBdaveUAr1Q7-4Y5&q=85&s=d89d5b087868696892f9e0bee89aad9f" alt="Finishing the service hook setup in Azure DevOps" width="1358" height="1470" data-path="images/help-centre/syncing-incidents-to-azure-devops/screenshot-9.png" />
