---
title: MS Teams Alert Notifications
description: Configure an MS Teams incoming webhook and connect it to DurableStack alert dispatch.
order: 47
---

# MS Teams Alert Notifications

Use this guide to send DurableStack alert notifications to an MS Teams channel.

## Before you start

- MS Teams alert dispatch is a Pro feature in DurableStack.
- You need Microsoft Teams permissions to create or manage an incoming webhook for the destination channel.
- You need access to the DurableStack app with organization-level integration management permissions.

## 1) Create an MS Teams incoming webhook

1. Open Microsoft guidance for Teams webhooks/connectors: [https://learn.microsoft.com/microsoftteams/platform/webhooks-and-connectors/how-to/connectors-using](https://learn.microsoft.com/microsoftteams/platform/webhooks-and-connectors/how-to/connectors-using)
2. Add an incoming webhook to the target channel.
3. Copy the webhook URL.

Treat this URL like a secret. Anyone with the URL can post to that channel.

## 2) Add the integration in DurableStack

1. In DurableStack, go to **Workspace > Organizations**.
2. Open **Manage Integrations** for your organization.
3. In **MS Teams Integrations**, select **Add MS Teams Integration**.
4. Enter:
   - **Name**: a clear destination label (example: `MS Teams Incident Channel`)
   - **Target URL**: the Teams incoming webhook URL
5. Save the integration.

Integrations are organization-scoped, so they can be reused across projects in the same organization.

## 3) Send a test notification

From the Organization Integrations page, click **Test** on the MS Teams integration.

- If the test succeeds, Teams should receive a sample alert card.
- If it fails, DurableStack shows an error toast with details.

## 4) Use the integration in an alert rule

1. Go to **Alerts > Manage Alerts** for your project.
2. Create or edit a rule.
3. In **Dispatch**, enable **MS Teams**.
4. Choose one of:
   - an existing MS Teams integration, or
   - **Create new integration** and save it inline
5. Save the alert rule.

## Troubleshooting

- `summary/text is required` style errors: Teams rejected the payload because required card fields were missing.
- Message delivery failed: webhook URL may be invalid, removed, or no longer authorized for the channel.
- Connector not found/invalid/disabled: recreate the webhook and update the DurableStack integration target URL.

## Security and operations

- Store webhook URLs in secure secret systems during setup and rotation workflows.
- Rotate webhook URLs periodically and after channel administration changes.
- Use integration names that clearly map to team ownership and escalation paths.