> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://respan.ai/docs/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://respan.ai/docs/_mcp/server.

# Microsoft Teams

#### Set up Respan

1. **Sign up** — Create an account at [platform.respan.ai](https://platform.respan.ai)
2. **Create an API key** — Generate one on the [API keys page](https://platform.respan.ai/platform/gateway/api-keys)
3. **Add credits or a provider key** — Add credits on the [Credits page](https://platform.respan.ai/platform/gateway/credits) or connect your own provider key on the [Integrations page](https://platform.respan.ai/platform/gateway/api-keys?providers=1)

#### Use AI

Add the [Docs MCP](/docs/documentation/get-started/mcp/docs-mcp) to your AI coding tool to get help building with Respan. No API key needed.

```json
{
  "mcpServers": {
    "respan-docs": {
      "url": "https://mcp.respan.ai/mcp/docs"
    }
  }
}
```

Connect Microsoft Teams to Respan so monitors, automations, and other workflow notifications can post directly to a Teams channel. The connection is per-organization and signs in through your Microsoft work or school account — messages are posted on behalf of the user who connects, and the teams and channels that user can see become available as notification destinations.

> **Note**
>
> Microsoft Teams is only available on work or school (Microsoft 365) accounts. Personal Microsoft accounts are not supported.

## Connect Microsoft Teams

#### Open the Integrations page

Go to the [Integrations page](https://platform.respan.ai/platform/settings/integrations) under Settings. Find **Microsoft Teams** in the Notification section and click **Connect**.

![Microsoft Teams row on the Respan Integrations page](/docs/_fern-img/4fbde2b9cc29b056f3792ada2e4c07a0233bb8000f60dd94ec8a61357b8f7551.webp)

#### Approve Respan in Microsoft

Clicking **Connect** opens a Microsoft sign-in popup. Sign in with your work or school account, review the permissions Respan is requesting, and accept. The popup closes on its own once the handshake finishes, and the Integrations page refreshes to show the connected state.

Respan requests the minimum delegated permissions needed to post messages and let you pick channels:

| Permission                       | Purpose                                                      |
| -------------------------------- | ------------------------------------------------------------ |
| `Team.ReadBasic.All`             | List the teams you belong to in the team picker              |
| `Channel.ReadBasic.All`          | List channels within a team in the channel picker            |
| `ChannelMessage.Send`            | Post notification messages to the selected channel           |
| `User.Read`, `openid`, `profile` | Identify the connecting user                                 |
| `offline_access`                 | Keep the connection alive by refreshing tokens automatically |

> **Note**
>
> Depending on your organization's Microsoft Entra settings, an admin may need to approve Respan before members can connect. If you see a "Need admin approval" screen, ask your Microsoft 365 admin to grant consent, then connect again.

## Use Microsoft Teams in Respan

Once connected, Microsoft Teams shows up as a notification destination anywhere Respan sends alerts.

### Monitor alerts

Open a [monitor](/docs/documentation/features/monitoring/monitors) and, under **Notifications**, select **Microsoft Teams**. Teams addressing is two-level: first pick a team, then pick a channel within it — both dropdowns are searchable and fetched live from your connected account.

![Team and channel picker dropdowns for Microsoft Teams notifications in Respan](/docs/_fern-img/efb4cf9610d4690c59f6616770bbf9baa3694b47899e0d177e4ebfce900850aa.webp)

> **Note**
>
> Messages are posted on behalf of the user who connected the integration, so the picker shows the teams and channels that user is a member of — including their private channels. If a channel is missing, the connecting user needs to be added to it in Teams first.

### Multiple destinations

A single monitor or automation can post to more than one Teams channel. Add each channel as its own notification destination — Respan will fan out the message.

## Disconnect Microsoft Teams

On the Integrations page, click **Disconnect** on the Microsoft Teams row. Respan deletes its stored tokens and channel references. You can reconnect at any time; previous monitor configurations that referenced Teams channels will need a new channel selection after reconnecting.

> **Note**
>
> Disconnecting removes the connection on the Respan side. To also revoke Respan's access grant in Microsoft, remove **Respan** from [myapplications.microsoft.com](https://myapplications.microsoft.com), or have an admin remove it under **Enterprise applications** in the Microsoft Entra admin center.

## Troubleshooting

#### The popup shows a "Need admin approval" screen

Your organization's Microsoft Entra settings require admin consent for new apps. Ask a Microsoft 365 admin to approve Respan — either through the approval request in that screen or by granting consent in the Entra admin center — then click **Connect** again.

#### A team or channel is missing from the picker

The picker only lists teams and channels the connecting user is a member of. Add that user to the team or channel in Microsoft Teams, then reopen the picker.

#### Alerts stopped arriving after a long pause

Respan refreshes Microsoft tokens automatically, but the refresh token itself can be invalidated — for example when the connecting user's password is reset, their account is disabled, or an admin revokes the app's sessions. Disconnect and reconnect on the Integrations page to issue fresh tokens.