How to integrate Teambox with Github

← Integrations

To integrate Teambox with your Github repo, just follow these simple steps.
The steps to use GitHub webhooks are the following:

Go to your Admin page in Github:

Go to Service Hooks:

Configure a Post Request Hook. This means Github will notify Teambox every time there’s a new commit:

Make sure you replace “your-project” in https://teambox.com/projects/your-project/hooks/github with your project URL and click on Update Settings:

There are two modes in which the Github hook works:

Tasks mode (default)

Only commit messages containing a task ID will be posted to Teambox. A comment will be inserted with your commit notes into the right task.

For each commit message you have to specify existing task id, for example when using git in shell:

git commit -m "Added cukes and specs [123456]"

or if you want to mark a task as resolved as well:

git commit -m "Added cukes and specs [close-123456]"

Commits will appear in the given task as a comments:

All you need to do is to add in POST-Receive URL additional parameter:

You may also just add it to POST request parameters.

Commits will appear as new conversations in your project: