Legacy Client

New Client

GitHub for Slack

GitHub brings teams of software developers together to write code and manage projects. When you connect GitHub to Slack, you can get notified of all sorts of events in the Slack channels of your choosing. Connect two of your most important tools and stay on top of your work, all from Slack. 🛠


Decide which app to use

  • GitHub for Slack: Are you on the GitHub Developer, Team, or Business plan? This app is for you!
  • Github Notifications (Legacy): This app is compatible with GitHub Enterprise.

Note: GitHub has released a new version of the GitHub app for Slack, and will be ending support for the current version in July 2020.


Install the app

GitHub for Slack 

GitHub Notifications (Legacy)

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 Add to Slack.
  2. Review the permissions the app needs to access, and click Continue to allow.
  3. Select the channels the app can access: all public channels, specific ones, or none.

After you've installed the app, the GitHub app will send you a direct message to help you complete setup and teach you about the /github slash command.

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



Customize your notifications

The GitHub app makes it easy to customize 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:

Features enabled by default

  • issues
  • pulls
  • statuses
  • commits
  • deployments
  • public

Features not enabled by default

  • reviews
  • comments
  • branches
  • commits:all

 

You can use these slash commands to customize 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 Install, or Add Configuration if one already exists.
  3. Select a channel where GitHub events will be posted, or click create a new channel to make a brand new one.
  4. Click Add GitHub Integration.
  5. In your GitHub account, go to the repository that you'd like to monitor. Click Settings in the top navigation.
  6. Click on Webhooks in the left navigation, then press Add webhook.
  7. From the Slack App Directory window, click Copy URL.
  8. Returning to your GitHub account, paste the URL under Payload URL.
  9. For the Content type, make sure application/json is selected.
  10. Confirm SSL verification is turned on.
  11. Click Add webhook.
  12. Return to your Slack setup page and click Save Integration.

Related Articles

Recently Viewed Articles