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

# Microsoft Teams Notifications

Allow your status page subscribers to receive incident and maintenance notifications directly in their Microsoft Teams channels.

{% hint style="info" %}
As a status page admin, enable Microsoft Teams notifications under <mark style="background-color:green;">Subscriptions > Sub. Settings</mark> before your customers can subscribe.
{% endhint %}

## Enable Teams notifications (admin)

1. In your status page admin sidebar, click **Subscriptions**, then **Sub. Settings**.
2. Check **Enable Microsoft Teams notification** and click **Submit**.\
   \
   ![Enable Microsoft Teams notifications setting](https://4061983002-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgIMm5p2V7PNx3dS7vwKE%2Fuploads%2Fgit-blob-9399b650da9a092b33d0cb61e80ac7c753c979a5%2Fnotifications-teams-enable-setting.png?alt=media)

## How subscribers connect Teams

Once enabled, subscribers will see a Microsoft Teams option in the **Subscribe to Updates** modal on your status page.

![Microsoft Teams option in subscribe modal](https://4061983002-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgIMm5p2V7PNx3dS7vwKE%2Fuploads%2Fgit-blob-f04035c726481816aecf3f9affc6ad8491e99fa7%2Fnotifications-teams-subscribe-option.png?alt=media)

To subscribe, they need an **Incoming Webhook URL** from Microsoft Teams:

1. In Microsoft Teams, click **Apps** and search for **Incoming Webhook**.
2. Click **Add to a team**, select the team/channel, and click **Set up a connector**.
3. Enter a name (e.g. "Acme Status") and click **Create**.\
   \
   ![Microsoft Teams Incoming Webhook setup](https://4061983002-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgIMm5p2V7PNx3dS7vwKE%2Fuploads%2Fgit-blob-b472a1e60f6cf43e24a2e098ac7091863b6e0a29%2Fnotifications-teams-incoming-webhook-setup.png?alt=media)
4. Copy the generated webhook URL.\
   \
   ![Copy Teams webhook URL](https://4061983002-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgIMm5p2V7PNx3dS7vwKE%2Fuploads%2Fgit-blob-05d773a672a069d2afc2b24541ae56effcbc94d1%2Fnotifications-teams-webhook-url.png?alt=media)
5. Paste the URL into the **Microsoft Teams webhook URL** field in the subscribe modal and click **Subscribe**.\
   \
   ![Subscribe with Teams webhook URL](https://4061983002-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgIMm5p2V7PNx3dS7vwKE%2Fuploads%2Fgit-blob-fb65f20b6a8e7dd984ae69110fcfd3ac10f7312f%2Fnotifications-teams-subscribe-modal.png?alt=media)

A confirmation message will appear in the Teams channel immediately upon subscribing.