With the GitHub app, you can get link previews in Slack for public repositories, set up notifications with slash commands and easily stay up to date on project activity.

Install the app

1. Visit slack.github.com and click on Add to Slack.
2. Review the permissions that the app needs to access, and click on Continue to allow.
3. Select the channels that the app can access: all public channels, specific ones or none.

Once you’ve installed the app, the GitHub app will send you a direct message to help you complete set-up and teach you about the /github slash command.

Tip: Use the slash command /github subscribe owner/repo to subscribe to your previous configurations.

Customise your notifications

The GitHub app makes it easy to customise what gets posted in Slack. You can subscribe to activity that’s relevant for the whole channel to see, and unsubscribe from other types that are less helpful. Certain activities will notify you in Slack by default, while some others won’t:

You can use the following slash commands to customise your notifications:

• /github subscribe owner/repo [feature]
• /github unsubscribe owner/repo [feature]

Install the app

1. Visit GitHub in the Slack App Directory.
2. Click on Install, or Add configuration if one already exists.
3. Select a channel where GitHub events will be posted, or click on Create a new channel to make a brand-new one.
4. Click on Add GitHub integration.
5. In your GitHub account, go to the repository that you’d like to monitor. Click on Settings in the top navigation.
6. Click on Webhooks in the left navigation, then Add webhook.
7. From the Slack App Directory window, click on Copy URL.
8. Returning to your GitHub account, paste the URL under Payload URL.
9. For the Content type, make sure that application/json is selected.
10. Confirm that SSL verification is turned on.
11. Click on Add webhook.
12. Return to your Slack set-up page and click on Save integration.