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

If you can't add a connection 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.

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:

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

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.

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

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

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:

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.

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 from the Microsoft documentation for further styling options. For the list of available variables and references please check out the Webhooks documentation page.

Last updated