By granting the GitHub app access to your Microsoft Teams workspace, you are providing necessary authorizations to your GitHub account and your Teams workspace. These permissions enable the app to perform its functions and provide you with a seamless experience when using GitHub in Teams.
Teams permissions
When you install the GitHub app in your Teams workspace, you are authorizing the app to access certain information and perform specific actions within your Teams workspace. The app requires the following permissions:
| Permission scope | Why we need it |
|---|---|
| Access private conversations between you and the App | To message you with instructions. |
| Add link previews to GitHub to messages | To render rich links to github.com. |
| Add GitHub commands | To add the @GitHub Notifications command to your Teams channels. |
| View the workspace or organization's name, email domain, and icon | To store subscriptions you set up. |
| Post messages as the app | To notify you of activity that happens on GitHub, in Teams. |
GitHub permissions
When you connect your GitHub account to the GitHub app in Teams, you are authorizing the app to access your GitHub account. The app requires the following permissions:
| Permission scope | Why we need it |
|---|---|
| Read access to issues, metadata, pull requests, discussions, and repository projects | To render previews of links shared in Teams. |
| Read access to code | To render code snippets in Teams. |
| Write access to actions, issues, and pull requests | To take action from Teams with cards and commands. |