Azure DevOps integration with Microsoft Teams

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

This article describes how you can integrate your Azure DevOps project activities directly into your Microsoft Teams channels. For example, you can see the following Azure DevOps events in your Teams channels:

  • Work item updates
  • Pull requests
  • Code commits
  • Builds
  • Release deployments and approvals

Requirements and limitations

  • To create Azure DevOps subscriptions in Teams, you must have Project Administrator permissions in your Azure DevOps project.

  • To receive Azure DevOps notifications in Teams, you must have Third party application access via OAuth enabled in your Azure DevOps organization settings.

  • Only Azure DevOps organizations in the same Microsoft Entra tenant as your Microsoft Teams account can be connected. Even if your email addresses are the same for Azure DevOps and Microsoft Teams, they can't be linked if they're backed by different tenants. For more information, see Access via Microsoft Entra FAQs.

  • Office 365 Connectors within Teams are being retired, and you might be unable to create new connectors. For more information, see Retirement of Office 365 connectors within Microsoft Teams. Features that provide similar functionality to Office 365 Connectors with better scalability and security include Workflows or the Azure DevOps Services apps for Teams.

Azure DevOps Services apps for Teams

Note

This feature is only available on Azure DevOps Services. Typically, new features are introduced in the cloud service first, and then made available on-premises in the next major version or update of Azure DevOps Server. For more information, see Azure DevOps Feature Timeline.

You can use the following apps that offer rich features to integrate with Microsoft Teams.

Azure Boards app for Teams

The Azure Boards app for Teams helps you easily create and monitor work items from your Teams channels. You can create work items by using a command, or use message actions to convert conversations in the channel into work items. You can also set up and manage subscriptions to get notifications in your channel whenever work items are created or updated. For more information, see Use the Azure Boards app in Microsoft Teams.

Azure Pipelines app for Teams

The Azure Pipelines app for Teams helps you easily monitor events in your pipelines from your Teams channels. You can set up and manage subscriptions for completed builds, releases, and pending approvals, and get notifications for these events in your channels. You can also approve builds and release deployments from your channels. For more information, see Integrate Azure Pipelines with Microsoft Teams.

Azure Repos app for Teams

The Azure Repos app for Teams helps you easily monitor events in your repositories from your Teams channels. You can set up and manage subscriptions for code commits, pull request (PR) creation, and PR updates, and get notifications for these events in your channels. For more information, see Use Azure Repos with Microsoft Teams.

Add and configure the Azure DevOps tab in Teams

To bring your project dashboard or Kanban board into Teams, you can install the Azure DevOps app in a tab in your Teams channel. The Azure DevOps app lets you insert content from the app in messages, and get notifications from the app in your channels.

  1. In Teams, select Apps from the left menu and then search for Azure DevOps.

    Screenshot that shows searching for Azure DevOps in Teams.

  2. Select Azure DevOps, and then select Add to a team.

  3. Select the Teams channel to add to the app to, and then select Set up.

    Screenshot that shows selecting Set up for Azure DevOps in Teams.

  4. Select Select organization, select your organization, and then select Continue.

    Screenshot that shows choosing the DevOps organization for Teams integration.

  5. On the Azure DevOps screen, select a Project, and whether to add a Dashboard or a Kanban board to the tab. Select other configurations depending on your choice, and select whether you want to post to the channel about adding the tab.

    Screenshot that shows adding a Dashboard for Azure DevOps in Teams.

  6. Select Save. The new tab and board appear in your channel.

    Screenshot that shows a Dashboard for an Azure DevOps project in Teams.

Add the Azure DevOps Server app to a team

The Azure DevOps Server connector sends notifications about activities in your projects.

Note

Office 365 Connectors within Teams are being retired, and new Office 365 Connector creation might be blocked. For more information, see Retirement of Office 365 connectors within Microsoft Teams. If you can't access the Connectors page from within the Teams desktop client, try using the Teams web client. The Workflows app in Teams provides similar functionality with better scalability and security.

  1. In Teams, select Apps from the left menu and then search for Azure DevOps Server.

    Screenshot that shows searching for Azure DevOps Server in Teams.

  2. Select Azure DevOps Server, and then select Add to a team.

  3. Select the channel to add to the app to, and then select Set up a connector.

    Screenshot that shows selecting Set up a connector for Azure DevOps Server in Teams.

  4. On the Azure DevOps Server page, enter a name for the new Azure DevOps Server connection, and then select Create.

    Screenshot that shows creating the Azure DevOps Server connection in Teams.

To manage your Teams apps and tabs, select Apps in the Teams menu and then select Manage your apps at the bottom of the Apps panel.