Skip to main content

Permissions for GitHub in Teams

Learn about the permissions required for the GitHub app in Teams to function.

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 scopeWhy we need it
Access private conversations between you and the AppTo message you with instructions.
Add link previews to GitHub to messagesTo render rich links to github.com.
Add GitHub commandsTo add the @GitHub Notifications command to your Teams channels.
View the workspace or organization's name, email domain, and iconTo store subscriptions you set up.
Post messages as the appTo 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 scopeWhy we need it
Read access to issues, metadata, pull requests, discussions, and repository projectsTo render previews of links shared in Teams.
Read access to codeTo render code snippets in Teams.
Write access to actions, issues, and pull requestsTo take action from Teams with cards and commands.

Additional permissions for Agent de programmation Copilot

Permission scopeWhy we need it
Write access to contentTo open pull requests authored by Agent de programmation Copilot.
Read/write access to workflowsTo initiate Agent de programmation Copilot sessions.