Skip to content
StatusOwlDocs

Microsoft Teams integration

Post adaptive cards to a Teams channel via an Incoming Webhook connector.

Last updated May 9, 2026

The Microsoft Teams integration delivers alerts through an Incoming Webhook connector. Each connector is scoped to a single Teams channel.

Creating the Teams connector

  1. In Teams, navigate to the target channel, click the ··· menu, and choose Connectors.
  2. Find Incoming Webhook and click Configure.
  3. Give the connector a name (e.g. StatusOwl), optionally upload an image, and click Create.
  4. Copy the generated webhook URL.

New Teams tenants

Some Microsoft 365 tenants are migrating to the new Workflows model, which replaces Incoming Webhook connectors. If your admin has disabled connectors, use the Workflows "Post to a channel when a webhook request is received" template and paste the resulting URL into StatusOwl.

Connecting it to StatusOwl

  1. Go to Integrations → Add Integration and choose Microsoft Teams.
  2. Paste the webhook URL.
  3. Choose which events to subscribe to (see event coverage for what currently fires).
  4. Click Save, then Send Test to confirm the card lands in Teams.

What currently sends to this integration

Per the integrations overview, Teams integrations receive:

  • Send Test events fired from the dashboard.
  • Watch Owl alert rules — when a host-metric rule routes to this integration, firing and resolving alerts post as themed MessageCard payloads.

Uptime-monitor state changes (down / recovery / maintenance) are configured on the integration but not yet dispatched. The flags are ready for the dispatch service when it ships.

Card format

Watch Owl alert cards render with a severity-driven theme color. The card summary surfaces the rule name and host; the body lists the metric, current value, threshold, and timestamp; an action button links back to the Watch Owl host detail in the StatusOwl dashboard.

When uptime-monitor state-change dispatch ships, card format for those events will be documented here.

See also