Microsoft Teams notifications

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, find and select the workflow template “Post to a channel when a webhook request is received”.

   

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

• Setting up an incoming webhook on Microsoft Teams