> For the complete documentation index, see [llms.txt](https://docs.runway.team/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.runway.team/integrations/notifications/microsoft-teams.md).

# Microsoft Teams

<div align="left"><figure><img src="/files/nFcZayWQsHLlaFv96WCR" alt=""><figcaption></figcaption></figure></div>

## Set up

### Navigate to the Integration settings view

1. Select an app in the top left corner from the Switcher
2. Navigate to **App Settings** by clicking the gear icon (⚙️) at the top of the Timeline sidebar
3. Click on **Integrations** in the sidebar

### **Connect Microsoft Teams**

{% hint style="warning" %}
**Important!** Before connecting a Teams integration, we recommend creating a user in your Microsoft Teams organization called "Runway" that will be used for authentication. This will ensure that messages sent by Runway are correctly attributed to the Runway user instead of the user that completed the installation.
{% endhint %}

* Find the **Microsoft Teams** integration module under the **Notifications** section
* Click the **Connect** button
* You’ll be taken through a standard Microsoft Teams OAuth flow

<details>

<summary><em>Runway will request the following permissions:</em></summary>

`channelmessage.send`  - Send messages to channels

`groupmember.read.all`  - Read who belongs to groups

`channel.readbasic.all`  - List channels and their basic info

`channel.create` - Create new channels

`team.readbasic.all` - Read users' profiles&#x20;

`user.read.all` - Delete channels

`user.read`  - Read the signed-in user's profile

`channel.delete.all`  - Delete channels

`chat.create`  - Create new chats

`chatmessage.send`  - Send messages in chats

`teammember.read.all`  - Read who belongs to Teams

`openid`  - Sign user in (authentication)

`offline_access` - Refresh tokens for ongoing access

`profile`  - Read basic profile info during sign-in

`teamworktag.read`  - Read tags

`teamworktag.readwrite`  - Create and manage tags

`group.readwrite.all` - Full read/write access to all groups

</details>

* Teams redirects you back to Runway
* Select the **Primary channel** you want notifications to go to. You can select or enter multiple channels.

{% hint style="info" %}
You can override default channel(s) for individual notifications by going to **App settings > Notifications** and clicking the :gear: icon for the notification you want to configure to send to a different channel.
{% endhint %}

{% hint style="warning" %}
Runway can send notifications to **private** channels, but only once the [Runway user](#user-content-fn-1)[^1] has been given access to the channel.
{% endhint %}

[^1]: The authenticated account used to connect Runway to Teams