Permissions for GitHub in Slack - GitHub Docs

https://docs.github.com/en/integrations/reference/slack-permissions • 91 KB fetched
Open original page
Permissions for GitHub in Slack - GitHub Docs Skip to main content
GitHub Docs Version: Free, Pro, & Team
Search or ask Copilot Search or ask Copilot

Select language: current language is English

Search or ask Copilot Search or ask Copilot

Open menu

Collapse sidebar Expand sidebar
Scroll breadcrumbs left
* Home

* Integrations

* Reference

* Slack permissions

Scroll breadcrumbs right

Integrations

*
*

* Concepts

* About integrations

* Featured integrations

* About building integrations

* GitHub Developer Program

* How-tos

* Slack

* Integrate GitHub with Slack

* Use GitHub in Slack

* Customize notifications

* Teams

* Integrate GitHub with Teams

* Use GitHub in Teams

* Customize notifications

* Schedule reminders

* Reference

* Slack permissions

* Teams permissions

* Teams command reference

* Tutorials

* Slack

* Create issues

* Manage issues

* Teams

* Create issues

* Manage issues and PRs

Permissions for GitHub in Slack

Learn about the permissions required for the GitHub integration in Slack.

Copy as Markdown

In this article

* Slack permissions

* GitHub permissions

By granting the GitHub integration access to your Slack workspace, you are providing necessary authorizations to your 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 GitHub integration 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 GitHub account to the GitHub integration in Slack, 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 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 Copilot cloud agent
Read/write access to workflows To initiate Copilot cloud agent sessions

Back to top

Help and support
Was this Doc helpful?
Yes No

Help us make GitHub Docs great!
All Docs are open source. See something that's wrong or unclear? Submit a pull request.
Make a contribution

Still need help?
Ask the GitHub community Contact support Expert services Blog

GitHub Inc. © 2026 Terms Privacy Status Pricing
Permissions for GitHub in Slack - GitHub Docs

Links found on this page
