# Integration for Microsoft Teams

You can integrate IncidentHub with Microsoft Teams to receive notifications in your chosen channel. IncidentHub sends these notifications using AdaptiveCards.

IncidentHub will send messages to your Teams channels when any of the following happens:

1. An incident or maintenance is triggered, updated, or resolved in any of your monitored services.
2. An upcoming maintenance reminder is triggered based on your chosen time interval.

## In Your Microsoft Teams Account

1. Login to your Microsoft account and click on "Teams and channels" on the left sidebar.

<figure><img src="https://1097519083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1UERJeGV9Jx1B0oddXCx%2Fuploads%2F5WdLUZcepC5XSru2itu2%2FScreenshot%20from%202025-10-13%2011-07-57.png?alt=media&#x26;token=3afa03e2-23ae-4fcf-bf7e-66e4a0814c6e" alt=""><figcaption></figcaption></figure>

2. Click on the 3 dots (...) next to the channel you wish to receive notifications in.
3. Click on "Workflows" in the menu.
4. In the popup window, search for "webhook" and choose the template "Send webhook alerts to a channel".

<figure><img src="https://1097519083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1UERJeGV9Jx1B0oddXCx%2Fuploads%2F9Dftt2fb5ux5eSIfBmYw%2FScreenshot%20from%202025-10-13%2011-08-15.png?alt=media&#x26;token=951b45b6-084c-452e-a4d8-258f534da9db" alt=""><figcaption></figcaption></figure>

5. Put a descriptive name for the workflow.

<figure><img src="https://1097519083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1UERJeGV9Jx1B0oddXCx%2Fuploads%2F83082TvTfrvRagi33q2o%2FScreenshot%20from%202025-10-13%2011-08-39.png?alt=media&#x26;token=d3b5f993-0b41-4b94-bd57-acd09bc51e48" alt=""><figcaption></figcaption></figure>

6. Confirm the Team and the Channel name.

<figure><img src="https://1097519083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1UERJeGV9Jx1B0oddXCx%2Fuploads%2FhilDtRy0R2WUvUS4ApEy%2FScreenshot%20from%202025-10-13%2011-08-56.png?alt=media&#x26;token=81d5d011-706d-4356-9311-d6347f2047c6" alt=""><figcaption></figcaption></figure>

7. Click on Add workflow.
8. Copy the HTTPS URL on the next screen. You will use it in the next steps.

<figure><img src="https://1097519083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1UERJeGV9Jx1B0oddXCx%2Fuploads%2FvaVlDMErxzT8rcd7fuzg%2FScreenshot%20from%202025-10-13%2011-09-11.png?alt=media&#x26;token=88412315-ef34-414a-af14-5ddbab76b3b4" alt=""><figcaption></figcaption></figure>

## In Your IncidentHub Account

1. Login to your IncidentHub account and click on Channels -> Add -> Microsoft Teams.
2. Add a Name and and a Description.
3. Under "Microsoft Teams Workflow URL", paste the URL that you had copied earlier.

<figure><img src="https://1097519083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1UERJeGV9Jx1B0oddXCx%2Fuploads%2FV1A7DkUpWv4ulAfumPEW%2FScreenshot%20from%202025-10-13%2011-04-04.png?alt=media&#x26;token=fa91c445-5924-4846-806a-26f0629d8a67" alt=""><figcaption></figcaption></figure>

4. To ensure the URL is valid and IncidentHub is able to connect to it, you can click on "Send a test message". This will send a test notification to your Microsoft Teams channel.
5. Click Save.

## Understanding Notifications

A Microsoft Teams notification sent by IncidentHub looks like this:

<figure><img src="https://1097519083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1UERJeGV9Jx1B0oddXCx%2Fuploads%2F7aAzrjZT3uT9YSevNacy%2FScreenshot%20from%202025-10-13%2011-04-28.png?alt=media&#x26;token=fbac8508-faaf-4e4c-b0a7-6a4db43b0ba5" alt=""><figcaption></figcaption></figure>

The colored bar on the left indicates the type of the notification.&#x20;

The different color codes are:

<div align="center" data-full-width="false"><figure><img src="https://1097519083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1UERJeGV9Jx1B0oddXCx%2Fuploads%2FNKF0X5Hv6jPReQvPlrXe%2Factive-incident.png?alt=media&#x26;token=920ccf66-1b43-4275-8981-794863f8f10b" alt=""><figcaption><p>Incident triggered or updated</p></figcaption></figure></div>

<div align="center"><figure><img src="https://1097519083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1UERJeGV9Jx1B0oddXCx%2Fuploads%2F8vkePesq3yWlcQP8PvFF%2Fresolved.png?alt=media&#x26;token=1448ec92-f451-4691-af07-3d74dd5c6af6" alt=""><figcaption><p>Incident resolved or maintenance completed</p></figcaption></figure></div>

<div align="center"><figure><img src="https://1097519083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1UERJeGV9Jx1B0oddXCx%2Fuploads%2FRCpwXRv5bTbYUspwPvLD%2Fongoing-maintenance.png?alt=media&#x26;token=5b8d89c5-78a1-4caa-aff6-2553e67dcf69" alt=""><figcaption><p>Maintenance ongoing</p></figcaption></figure></div>

<div align="center"><figure><img src="https://1097519083-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F1UERJeGV9Jx1B0oddXCx%2Fuploads%2FeELRyvMPdSATOqlqqtCx%2Fupcoming-maintenance.png?alt=media&#x26;token=52c38bc2-ee1b-402c-a86c-740b24cca7b5" alt=""><figcaption><p>Upcoming maintenance reminder</p></figcaption></figure></div>

The notification title also has the type of the notification, but the color gives you an easier way of quickly identifying it.
