> ## Documentation Index
> Fetch the complete documentation index at: https://docs.happyuptime.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Microsoft Teams

Post alerts to a Microsoft Teams channel via an incoming webhook.

# Microsoft Teams

Happy Uptime posts rich MessageCard alerts to Microsoft Teams via an incoming webhook. Works with both Workflows-based webhooks and the legacy Office 365 Connector URL.

## Create the incoming webhook

1. In Teams, right-click the target channel → **Workflows** → **Post to a channel when a webhook request is received** (or legacy **Connectors → Incoming Webhook**).
2. Name the webhook (e.g. "Happy Uptime") and copy the generated URL.

## Add the channel

```bash
curl -X POST https://happyuptime.com/api/v1/alerts/channels \
  -H "Authorization: Bearer $HU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Teams — Ops",
    "type": "teams",
    "config": {
      "webhookUrl": "https://prod-.../workflows/..."
    }
  }'
```

Cards include the monitor name, status, region, response time, error, incident title/severity/status, and vendor details depending on the event type. Each card has an **Open in Happy Uptime** button linking back to the dashboard.