Skip to content

Microsoft Teams notifications

DETAILS: Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

You can integrate Microsoft Teams notifications with GitLab and display notifications about GitLab projects in Microsoft Teams. To integrate the services, you must:

  1. Configure Microsoft Teams to enable a webhook to listen for changes.
  2. Configure your GitLab project to push notifications to the Microsoft Teams webhook.

Configure Microsoft Teams

WARNING: New Microsoft Teams integrations using Microsoft Connectors can no longer be created and existing integrations must be transitioned to workflow apps by December 2025. Microsoft announced the retirement of Microsoft Teams integrations using Microsoft Connectors.

To configure Microsoft Teams to listen for notifications from GitLab:

  1. In Microsoft Teams, find and select the workflow template "Post to a channel when a webhook request is received".

    Selecting a workflow webhook in Microsoft Teams

  2. Enter a name for the webhook. The name is displayed next to every message that comes in through the webhook. Select Next.

  3. Select the team and channel you want to add the integration to, then select Add workflow.

  4. Copy the webhook URL, as you need it to configure GitLab.

Configure your GitLab project

After you configure Microsoft Teams to receive notifications, you must configure GitLab to send the notifications:

  1. Sign in to GitLab as an administrator.
  2. On the left sidebar, select Search or go to and find your project.
  3. Select Settings > Integrations.
  4. Select Microsoft Teams notifications.
  5. To enable the integration, select Active.
  6. In the Trigger section, select the checkbox next to each event to enable it:
    • Push
    • Issue
    • Confidential issue
    • Merge request
    • Note
    • Confidential note
    • Tag push
    • Pipeline
    • Wiki page
  7. In Webhook, paste the URL you copied when you configured Microsoft Teams.
  8. Optional. If you enable the pipeline trigger, select the Notify only broken pipelines checkbox to push notifications only when pipelines break.
  9. Select the branches you want to send notifications for.
  10. Select Save changes.

Related topics