> For the complete documentation index, see [llms.txt](https://docs.meta-inf.hu/email-this-issue/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.meta-inf.hu/email-this-issue/administration/alerting-via-webhooks/webhooks/configuring-microsoft-teams-to-receive-alerts-via-webhooks.md).

# Configuring Microsoft Teams to receive alerts via webhooks

## General Information

In order to receive alerts via Microsoft Teams (MS Teams), you need to set up two configurations:

* create an **Incoming Webhook** **Connector** for your channel in Microsoft Teams
* setup a **Custom Webhook** in Email This Issue administration 

{% hint style="warning" %}
If you [can't add a connection](https://techcommunity.microsoft.com/t5/microsoft-teams/can-t-add-connector-to-team/m-p/2516559)[ ](https://techcommunity.microsoft.com/t5/microsoft-teams/can-t-add-connector-to-team/m-p/2516559)in your MS Teams desktop application, try doing it via the web version of Microsoft Teams. The steps are going to be the same for both platforms.
{% endhint %}

## Creating the Incoming Webhook Connector

In order to add the Incoming Webhook Connector, follow the below steps:

Open the MS Teams channel configuration panel and set up the **Incoming webhook connector** for the channel that you would want Email This Issue to send the alerts to. 

In this example, it's called *Alerting-Incidents*. Click on the three dots and open **Connectors:**

![Microsoft Teams channel settings](/files/06Sp9Xjdr04U6GsvS9Qp)

After the **App browser** pops up look for the **Incoming Webhook - Add** option:

![Incoming Webhook - Add panel](/files/zPGTpW6DViWRJpXnaoOM)

If you cannot see it; search for it using the search bar. Add the Incoming Webhook to your channel by clicking on the **Add** button.

![Incoming Webhook item in the App browser ](/files/TpZRM0Busm2M8wODnfbQ)

After adding the Webhook, you can name this connection and upload an image for it.<br>

![Icoming Webhook configuration panel ](/files/e7hOhtngEH8qakDdDnm8)

Clicking on the **Create** button will reveal the URL that Email This Issue needs to connect to your channel:

![Microsoft Teams Incoming Webhook service URL](/files/bjACZdC67GRCbXIhdhvq)

This concludes the setup process in Microsoft Teams.

## Configuring the Webhook in Email This Issue

In Email This Issue you need to create a **Custom Webhook**:

![Email This Issue Webhook creation panel](/files/Jflk3pdCjLrGgm71VnW6)

Copy the whole URL from the Incoming Webhook (in the Microsoft settings) and paste it in the **Service URL** section.\
There is no **API Token** needed, the **Request header** part can also be left as it is.

![Enail This Issue webhook configuration panel](/files/CAyhqRhxocSOzSEEn5TY)

You can also configure the message (request body) here. Above you can see an example for a very simple alert, but you can use the [syntax reference](https://docs.microsoft.com/hu-hu/outlook/actionable-messages/message-card-reference) from the Microsoft documentation for further styling options. For the list of available variables and references please check out the [Webhooks](/email-this-issue/administration/alerting-via-webhooks/webhooks.md) documentation page.