title: Permissions for GitHub in Slack
shortTitle: Slack permissions
intro: Learn about the permissions required for the GitHub app in Slack to function.
versions:
fpt: '*'
ghes: '*'
ghec: '*'
topics:
- Integration
contentType: reference
By granting the {% data variables.product.github %} app access to your Slack workspace, you are providing necessary authorizations to your {% data variables.product.github %} account and your Slack workspace. These permissions enable the app to perform its functions and provide you with a seamless experience when using GitHub in Slack.
Slack permissions
When you install the {% data variables.product.github %} app in your Slack workspace, you are authorizing the app to access certain information and perform specific actions within your Slack 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. |
| View links to GitHub.com in messages | To render rich links from github.com |
| Add link previews to GitHub.com to messages | To render rich links to github.com |
| Add slash commands | To add the /github slash command to your Slack workspace |
| 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 Slack |
GitHub permissions
When you connect your {% data variables.product.github %} account to the {% data variables.product.github %} app in Slack, you are authorizing the app to access your {% data variables.product.github %} account. The app requires the following permissions:
| Permission scope | Why we need it |
|---|---|
| Read access to code | To render code snippets in Slack |
| Read access to actions, commit statuses, checks, discussions, issues, metadata, pull requests, and repository projects | To render previews of links shared in Slack |
| Write access to actions, issues, deployments, and pull requests | To take action from Slack with the /github command and directly from messages |
| Write access to content | To open pull requests authored by {% data variables.copilot.copilot_coding_agent %} |
| Read/write access to workflows | To initiate {% data variables.copilot.copilot_coding_agent %} sessions |