Skip to content

slack.md

Latest commit

 

History

History
129 lines (83 loc) · 7.51 KB

slack.md

File metadata and controls

129 lines (83 loc) · 7.51 KB
ms.service azure-devops
ms.subservice azure-devops-integration
ms.topic how-to
title Integrate with Slack
description Discover how to connect Azure Pipelines to Slack for real-time updates on pipeline events.
ms.date 01/13/2026
monikerRange azure-devops

Use Azure Pipelines with Slack

[!INCLUDE version-eq-azure-devops]

This article shows you how to use the Azure Pipelines app for Slack to monitor your pipeline events. You can establish and manage subscriptions for pipeline events like builds, releases, and pending approvals. Notifications for these events are delivered directly to your Slack channels.

[!INCLUDE temp]

Prerequisites

  • A Slack account with permission to install an app to your Slack workspace.
  • An Azure DevOps project with Project Collection Administrators or Project Administrators permissions.
  • Must not be an external user in Microsoft Entra.

Install the Azure Pipelines app

Install the Azure Pipelines Slack app to your Slack workspace. Once the app installs, you see the following welcome message. Enter /azpipelines to start interacting with the app.

:::image type="content" source="media/integrations-slack/welcome-message.png" alt-text="Screenshot of the Azure Pipelines app welcome message.":::

Connect to your pipeline

After you install the app in your Slack workspace, connect the app to any pipeline you want to monitor. Authenticate to Azure Pipelines before running any commands.

:::image type="content" source="media/integrations-slack/sign-in.png" alt-text="Screenshot of the sign-in prompt message.":::

Note

If your Azure DevOps organization is connected to a Microsoft Entra ID tenant, you must sign in with a native member of that tenant. External users receive the following error if they try to sign in to the Azure Pipelines app: Configuration failed. Please make sure that the organization exists and that you have sufficient permissions.

Subscribe to pipelines

To start monitoring all pipelines in a project, enter /azpipelines subscribe <project url> in a channel, replacing <project url> with your Azure DevOps project URL. The project URL can link to any page within your project except pipeline pages, for example /azpipelines subscribe https://dev.azure.com/myorg/myproject/.

You can monitor a specific pipeline by using /azpipelines subscribe <pipeline url>. The pipeline URL can link to any page within your pipeline that has a definitionId or a buildId/releaseId in the URL. For example:

  • /azpipelines subscribe https://dev.azure.com/myorg/myproject/_build?definitionId=123
  • /azpipelines subscribe https://dev.azure.com/myorg/myproject/_release?definitionId=123&view=mine&_a=releases

The subscribe command subscribes you to the following notifications by default:

  • For YAML pipelines:
    • Run stage state changed
    • Run stage waiting for approval
  • For Classic build pipelines, Builds completed
  • For Classic release pipelines:
    • Release deployment started
    • Release deployment completed
    • Release deployment approval pending

:::image type="content" source="media/integrations-slack/events-subscription.png" alt-text="Screenshot of notification example." lightbox="media/integrations-slack/events-subscription.png":::

Manage subscriptions

To manage the subscriptions for a channel, enter /azpipelines subscriptions. This command lists all the current subscriptions for the channel and lets you add or remove subscriptions.

:::image type="content" source="media/integrations-slack/subscriptions-list.png" alt-text="Screenshot of a list of subscriptions.":::

Note

Team Administrators can't remove or modify subscriptions created by Project Administrators.

Customize subscriptions

The default subscriptions don't have any filters applied, but you can customize these subscriptions according to your preferences. For example, you might want to receive notifications only for failed builds or deployments to production. You can apply filters to customize which messages you receive in your channel.

To customize a subscription:

  1. Run the /azpipelines subscriptions command to list all your subscriptions.
  2. Select Add subscription.
  3. Select the event you want to subscribe to, and then select your desired configuration.
  4. Select Save.

To get notifications only for failed builds, select Failed under Build status.

:::image type="content" source="media/integrations-slack/custom-build-completed.png" alt-text="Screenshot of how to customize a subscription.":::

Approve deployments

You can approve deployments from your Slack channel without going to Azure Pipelines. Subscribe to the Run stage waiting for approval notifications for YAML pipelines or the Release deployment approval pending notifications for Classic releases. Both of these subscriptions are created by default when you subscribe to a pipeline.

:::image type="content" source="media/integrations-slack/approve.png" alt-text="Screenshot of pipeline approval in Slack.":::

The Azure Pipelines app for Slack lets you handle all the checks and approval scenarios that are available in the Azure Pipelines portal. These scenarios include single approver, multiple approvers, and team-based approval. You can approve requests either individually or on behalf of a team.

:::image type="content" source="media/integrations-slack/approved.png" alt-text="Screenshot of a predeployment pipeline approved in Slack.":::

Remove all subscriptions

To declutter your channel, use the /azpipelines unsubscribe all <project url> command to unsubscribe from all pipelines in a project. For example, /azpipelines unsubscribe all https://dev.azure.com/myorg/myproject.

Important

Only Project Administrators can run this command.

Command reference

The Azure Pipelines app for Slack supports the following commands:

Command Description
/azpipelines subscribe <pipeline url or project url> Subscribe to a pipeline or all pipelines in a project and receive notifications.
/azpipelines subscriptions Add or remove subscriptions for this channel.
/azpipelines feedback Report a problem or suggest a feature.
/azpipelines help Get help on the commands.
/azpipelines signin Sign in to your Azure Pipelines account.
/azpipelines signout Sign out of your Azure Pipelines account.
/azpipelines unsubscribe all <project url> Remove all project pipelines and their associated subscriptions from a channel.

Notifications in private channels

The Azure Pipelines app can also help you monitor pipelines activity in your private channels. You need to invite the bot to your private channel by using /invite @azpipelines. Once you add the bot, you can configure and control your notifications the same way as for a public channel.

Troubleshooting

[!INCLUDE troubleshooting]

Related articles