Get to know the basics, and a few helpful tips & tricks along the way!Want to learn more about setting up your team? Look no further!Supplemental Slack info for you and your team.Tips and tools for beginners and experts alike.Launching a new team or joining one for the first time?
Our easy-to-read guides help your team work better, together, from day one.Ready to level up? Browse our time-saving tricks and practical tips for
making Slack work for you.All kinds of teams thrive with Slack — take a look at our department-specific guides.
More coming soon!Get familiar with Slack Enterprise Grid for large organizations.If you're curious about what's new in Slack — and what's changed — you're in the right place.Develop your skills and prepare to become Slack Certified!
Slack is experiencing some connectivity issues — please stand by. Check Status
GitHub is an online Git repository service (a system that allows multiple people to work on the same code at once). GitHub makes it easy to store your Git projects, work with teammates, track issues, and keep things organized.
With the GitHub app for Slack, you can get Slack notifications for the following types of events:
PR review events
Connect GitHub to Slack
Tip: Before getting started, make sure you’ve already created your GitHub account. You can visit github.com to do so.
When you’re ready to connect GitHub to Slack, use the steps below:
Select a channel where GitHub events will be posted, or click create a new channel to make a brand new one.
Click Add GitHub Integration.
Click Authenticate your GitHub account.
Choose the repositories you’d like Slack notifications for.
Choose the GitHub events you’d like to post to Slack.
If you’d like, you can customize the way Github posts appear in Slack by choosing a custom display name and icon.
When you’re done, click Save Integration.
A note about permissions
Slack will ask your permission to access some GitHub repositories the first time you connect the app. We’ll need read and write access to all public and private repo data: code, issues, pull requests, wikis, settings, deploy keys, plus webhooks and services.
We understand this is a lot to ask! The only way Slack can access the full list of your public and private repos is with GitHub’s “repo” scope, which also provides all of the permissions listed above.
The only permissions Slack will use are the ones needed to read repo data (to get a list of your public and private repositories) and the write permission to configure your webhooks on GitHub.
Switch to unauthed mode
You can also set up the GitHub app in unauthed mode. This is helpful for two reasons: your team uses GitHub Enterprise or you don't want to grant Slack full read and write access.
To set up the GitHub app in unauthed mode, use steps 1-4 from the section above, then do the following:
From the Slack setup page, click switch to unauthed mode.
In your GitHub account, go to the repository that you'd like to monitor. Click Settings in the right navigation.
Click Webhooks & Services in the left navigation, then press Add webhook.
From the Slack App Directory window, click copy URL.
Returning to your GitHub account, paste the URL under Payload URL.
For the Content type, make sure application/json is selected.
Confirm SSL verification is turned on.
Click Add webhook.
Return to your Slack setup page and click Save Integration.
Add a new GitHub organization to Slack
When you join a new GitHub organization, you’ll need to allow Slack to access it. Once you do so, the new organization will display in your existing app.