Microsoft Teams notifications

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

To configure Microsoft Teams to listen for notifications from GitLab:

  1. In Microsoft Teams, type incoming webhook in the search bar, and select Incoming Webhook:

    Select Incoming Webhook

  2. Select Add to a team.
  3. Select the team and channel you want to add the integration to.
  4. Add a name for the webhook. The name is displayed next to every message that comes in through the webhook.
  5. 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.