With the Clubhouse GitHub integration, specially formatted commit messages can be used to link stories to commits, branches and pull requests, as well as move stories across your workflow.

Following these instructions, you can configure the Clubhouse GitHub integration to work with one or more GitHub repositories.

Setting up the integration in Clubhouse

1. In the Clubhouse app, click the Gear icon in the upper right corner, click Integrations, and then click GitHub.
2. Copy the GitHub Payload URL. Now head over to your GitHub repo page.

Setting up the integration in GitHub

1. From your repository page in GitHub, select the Settings tab.
2. On the settings page, click Webhooks.
3. Click Add webhook in the top right.
4. In the Payload URL box, enter the Payload URL you copied from our GitHub Integration dialog.
5. Under "Which events would you like to trigger this webhook", select Send me everything*.
6. Content type should be set to application/JSON
7. Click Add webhook.

Our GitHub integration is now enabled for this repository! Repeat these steps for any other repositories that you want to integrate using the same webhook URL.

*If you want to use the "Let me select individual events" option, you will need to have at least Create, Delete, Comment, Pull Request and Push selected to capture all events. See image below. 

Connecting Individual Accounts

Individuals will need to ensure that their primary email address in GitHub is the same as one of their email addresses in Clubhouse.

In Github, check your personal account settings, under the email tab.

If this is not the same email address used to create your Clubhouse account, you'll need to add that email address to Clubhouse.

GitHub Event Handlers

To set up your integration to use our GitHub Event Handlers, follow these instructions.

When you're done, make sure to check out our the guide to using our GitHub integration.