> 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="/files/oMLZqUKZcsnSx0QGcxPU" alt=""><figcaption></figcaption></figure>

**Configuration options**

1. Task name: This name will be visible in the pipeline later when it is executed.
2. Title: title of the message that will be posted to the Teams channel.
3. Message: text to be sent.
4. Webhook URL of your MS Teams channel.
5. Hide pipeline URL: Do not add the button with link to the pipeline in the adaptive card of 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: 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<br>

     <figure><img src="/files/WPdQEUM8EsHFyejNET0h" alt=""><figcaption></figcaption></figure>
   * The approver has to be Brainboard user

#### Setup instructions

If you want to configure Microsoft Teams to receive notifications from Brainboard 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 and open its configuration menu in the top-right corner and click on "Workflows":<br>

   <figure><img src="/files/6xTw27vfQGYrzmntYYhD" alt=""><figcaption></figcaption></figure>
2. This will open the workflows configuration wizard. Search and select the line "Post to a channel when a webhook request is received":

   <figure><img src="/files/1TGl55pxlxlipKBrbxNn" alt=""><figcaption></figcaption></figure>
3. Give it a name and click Next:<br>

   <figure><img src="/files/fzHcQFjANY6BB99bFm31" alt=""><figcaption></figcaption></figure>
4. Select the channel where you want the notification to be posted:<br>

   <figure><img src="/files/qO2D5BvSKJIghaljoZnN" alt=""><figcaption></figcaption></figure>
5. Copy the generated webhook URL to use in Brainboard:<br>

   <figure><img src="/files/UJ8dVKzd8r1BNLbzqjWs" alt=""><figcaption></figcaption></figure>

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

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

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