> For the complete documentation index, see [llms.txt](https://docs.brainboard.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.brainboard.co/automation/supported-plugins/notifications/microsoft-teams.md).

# Microsoft Teams

This plugin allows you to send a notification to your **MS Teams** channel.

<figure><img src="https://2733077811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7YhVIZuz5Brv8kisTlFL%2Fuploads%2FP7pXiLzJjmJne1687O7X%2FMS-Teams.png?alt=media&amp;token=30c1203f-1516-44f0-b57a-48f6101c8033" alt=""><figcaption></figcaption></figure>

**Configuration options**

1. **Task name:** This name will be visible in the pipeline when the task is executed.
2. **Message:** Text to be sent.
3. **Title:** Title of the message that will be posted to the **Teams** channel.
4. **Webhook URL** of your **MS Teams** channel.
5. **Hide pipeline URL:** Do not add a button with a link to the pipeline in the adaptive card for the message displayed in the **Teams** channel.
6. **Ignore failure:** If enabled, the execution of the following stage will be triggered even if the task fails.
7. **Require approval:** It means that this task will not be executed until approved by people added in the approvers' list.
   * The task remains blocked until all approvers added in the list approve it.
   * When enabled, it allows you to add approvers to the list.
   * The approver has to be a <mark style="color:$primary;">**Brainboard**</mark> user.

#### Setup instructions

If you want to configure **Microsoft Teams** to receive notifications from <mark style="color:$primary;">**Brainboard**</mark> pipelines, an ***incoming hook*** needs to be set up in the channel of your choice. To do so, follow the steps:

1. Go to your **Teams** channel where you want the notification to be posted, open its configuration menu in the top-right corner and click on **"**<mark style="color:$primary;">**Workflows**</mark>**."**<br>

   <figure><img src="https://2733077811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7YhVIZuz5Brv8kisTlFL%2Fuploads%2F6ofVgV2NGTYzT23KZC5u%2FCleanShot%202025-02-13%20at%2014.56.13%402x.png?alt=media&amp;token=b8737316-4214-4e07-88bb-8a6d596d5d75" alt=""><figcaption></figcaption></figure>

2. This will open the workflows configuration wizard. Search and select the line **"**<mark style="color:$primary;">**Post to a channel when a webhook request is received**</mark>**."**

<figure><img src="https://2733077811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7YhVIZuz5Brv8kisTlFL%2Fuploads%2FUg8nfHwEAehZma9UO5qD%2FCleanShot%202025-02-13%20at%2014.56.30%402x.png?alt=media&amp;token=a8e69f04-cf66-4e91-a448-66d634d4b7e1" alt=""><figcaption></figcaption></figure>

3. Give it a name and click <mark style="color:$primary;">**`Next`**</mark>.

<figure><img src="https://2733077811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7YhVIZuz5Brv8kisTlFL%2Fuploads%2FFeut7bUB7Vtf6AyvJGbO%2FCleanShot%202025-02-13%20at%2014.56.50%402x.png?alt=media&amp;token=c4017d09-9460-484e-a466-d7f9abb07d72" alt=""><figcaption></figcaption></figure>

4. Select the channel where you want the notification to be posted:

<figure><img src="https://2733077811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7YhVIZuz5Brv8kisTlFL%2Fuploads%2FeBBe6OWLHgx7C2HdXND8%2FCleanShot%202025-02-13%20at%2014.57.07%402x.png?alt=media&amp;token=72fd154b-09f5-423a-8759-64ded8aeeb2b" alt=""><figcaption></figcaption></figure>

5. Copy the generated **webhook URL** to use in <mark style="color:$primary;">**Brainboard.**</mark>

<figure><img src="https://2733077811-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7YhVIZuz5Brv8kisTlFL%2Fuploads%2FGW6VjnM1NViaSOURmXxE%2FCleanShot%202025-02-13%20at%2014.57.18%402x.png?alt=media&amp;token=c2fd13f9-ea4c-4d84-9de7-120d1d0d3ab3" alt=""><figcaption></figcaption></figure>

If you have an old configuration, follow the steps in this video:

{% embed url="<https://www.youtube.com/watch?v=LOvWCNyXxLE>" %}

{% hint style="warning" %}
This configuration is deprecated by **Azure** and will be removed by the end of 2025.
{% endhint %}