Over the last couple of weeks, we’ve been hard at work building out first integration…and it’s a good one!

GitHub is our (and probably everyone else’s) favourite place to store our code - so it was an obvious match for Matterhorn.

From today you can integrate Matterhorn with GitHub. By using certain strings in your commit messages, it will automatically move the ticket in Matterhorn.

How do I integrate GitHub with my Matterhorn project?

  1. Go to your Matterhorn project page and click on the cog in the top right to get to your project settings.
  2. Paste the Git URL* from your project’s GitHub Repository into the box on the integrations panel.
  3. Visit the settings page in the GitHub Repository and select Webhooks & Services**. Now click “Add Webhook”.
  4. Copy the provided Payload URL from the integrations panel into the webhooks “Payload URL” field. (this URL is private and unique to your project)
  5. Save and start moving around tickets with Git!

*If you need help finding your git URL, you find it in this box in your repository

**This is what the webhooks page looks like

How do I use the git integration?

Referencing tickets

Each ticket has a ticket id. You reference the ticket in github by using a # followed by the ticket id for example #162

If you just leave a reference we will add a comment to the ticket like so:

Moving tickets

Referencing is only the start of the integration. You can also move ticket around the board via the message

Opening Tickets

If you’re starting work on a ticket, you can move it to in progress by having any of these words in your commit message. breaks, unfixes, reopen, reopens, re-open, re-opens, open, opens

Completing tickets

If you’re starting work on a ticket, you can move it to complete by having any of these words in your commit message. close, closes, closed, fix, fixed, fixes

Here’s an example:

bash git commit -m "Implement GitHub Integration fixes #1540"

This will move the ticket to the complete column in Matterhorn :D

Thanks for reading!