---
title: "Microsoft Teams"
description: "Receive HawkScan notifications in Microsoft Teams channels."
url: https://docs.stackhawk.com/integrations/workflows/microsoft/teams/
---

# Microsoft Teams

![Microsoft Teams](https://docs.stackhawk.com/images/integrations/logos/ms-teams.svg)

StackHawk’s official [Microsoft Teams](https://teams.microsoft.com/l/app/3e43319b-c78c-40db-a261-3a97a8ca2abf) integration.

## Overview

The Microsoft Teams integration sends scan notifications to configured Teams channels. Notifications include scan start, completion, and error events with links back to StackHawk for full results.

## Features

- Receive notifications when scans start and complete
- View findings summaries directly in Teams
- Get error notifications with links to scan details
- Configure notifications per channel, application, and environment

![Teams scan completed notification](https://docs.stackhawk.com/images/integrations/msteams/msteams-scan-completed.png)

## Requirements

### StackHawk

- A StackHawk account with the Microsoft Teams integration enabled. [Contact Support](https://docs.stackhawk.com/support/) to enable it.

<a id="microsoft-teams"></a>

### Microsoft Teams

- Login access to the Teams workspace you want to connect
- Admin permissions to install Teams apps in your workspace

## Permissions

The integration requests these Microsoft Teams permissions:

- Receive messages and data you provide to it
- Receive messages and data team members provide in a channel
- Send messages and notifications in a channel
- Access team information (team name, channel list, member names and email addresses)

## Installation

1. Log into StackHawk and go to the [Teams Integration page](https://app.stackhawk.com/integrations/msteams/).
2. Click **Enable Teams** to generate a temporary integration token.
3. Click **View In Marketplace** to install the StackHawk app from the Microsoft Teams Marketplace.
4. In Teams, click **Add to a Team** and select the Team you want to connect.

You can also install directly from the [Microsoft Teams Marketplace](https://teams.microsoft.com/l/app/3e43319b-c78c-40db-a261-3a97a8ca2abf).

### Token Authorization

After installing the Teams app, connect it to your StackHawk organization:

1. Go to the [Teams Integration page](https://app.stackhawk.com/integrations/msteams/) in StackHawk.
2. Copy the integration token. The token expires after one hour.
3. In your Teams channel, send a direct message to the **@StackHawk** bot with the `connect` command followed by the token.
4. A success message confirms the connection.

![Teams authorization](https://docs.stackhawk.com/images/integrations/msteams/msteams-authorize.png)

## Configuration

Configure which Teams channels receive notifications and filter by application and environment.

![Teams integration configuration](https://docs.stackhawk.com/images/integrations/msteams/msteams-configure.png)

- Configuration is per-channel. Each channel can have different application and environment filters.
- With no applications selected, the channel receives notifications for all applications.
- With no environments selected, the channel receives notifications for all environments.
- Click the menu icon on any channel row to edit or remove its configuration.

![Edit Teams channel configuration](https://docs.stackhawk.com/images/integrations/msteams/msteams-edit.png)

**Note:** Private Teams channels cannot receive notifications.

## Troubleshooting

If notifications are not appearing in Teams:

1. Verify the channel is configured for the application and environment being scanned.
2. Check the [Microsoft 365 Service Status](https://portal.office.com/servicestatus) for outages.
3. Confirm the StackHawk app is still installed in the Teams workspace.
4. As a last resort, remove and reinstall the integration. This resets all channel configurations.

If issues persist, [contact StackHawk Support](https://docs.stackhawk.com/support/).

## Feedback

Have suggestions or feedback? [Contact StackHawk Support](https://docs.stackhawk.com/support/).