Adding Helix ALM webhooks to GitHub

Helix ALM supports integration with GitHub to allow users to attach commits to items when changes are pushed to repositories. Perform the following steps to integrate Helix ALM with GitHub.

1. In Helix ALM, add the GitHub source control provider. See Adding GitHub source control providers.

2. Copy the webhook payload URL from the Source Control Provider dialog box.

3. Log in to GitHub.

4. Click the repository you want to attach commits from.

The repository must match the repository specified for the GitHub provider in Helix ALM.

5. On the repository page, click Settings.

6. On the Settings page, click Webhooks & Services.

7. Click Add Webhook.

You may be prompted to confirm your password. Enter your password and click Confirm.

8. Paste the URL in the Payload URL field.

9. Select application/json as the Content type.

10. Select Just the push event for the events to trigger the webhook. This option is selected by default.

11. Select Active. This option is selected by default.

12. Click Add webhook.

The webhook is added.

To attach GitHub commits to items, provide the tag for the issue, test case, or requirement to attach to when committing changes in GitHub. See Attaching Git, GitHub, and Team Foundation Server files to items.