Configuring webhooks in GitHub Enterprise

You must configure a webhook for a GitHub repository to validate the communication between GitHub Enterprise and IBM® Engineering Workflow Management (Engineering Workflow Management).

About this task

After you validate this basic integration, you can configure the webhook to create Git commit links in Engineering Workflow Management work items or set up a pre-receive hook for process enforcement.
Note: A webhook is a pre-requisite for a pre-receive hook.


  1. Go to the GitHub repository page in the web browser.
  2. Click the Settings tab.
  3. In the navigation pane, click Hooks.
  4. Click Add Webhook.
  5. In the Payload URL field, paste the webhook URL that you copied in Registering the GitHub repository in Engineering Workflow Management.
  6. In the Content type field, select any content type (both JSON and x-www-form-urlencoded are supported).
  7. In the Secret Key field, provide the same secret that you provided in Registering the GitHub repository in Engineering Workflow Management.
  8. If you get this error when validating the webhook: Peer certificate cannot be authenticated with given CA certificates, then add the IBM Engineering Workflow Management (Engineering Workflow Management) server certificate to the GitHub Enterprise server. We do not recommend disabling SSL verification.
  9. Under Which events would you like to trigger this webhook?, select Let me select individual events. In the options displayed, ensure that the Pushes option is selected.
  10. Ensure that the Active check box is selected. This option keeps the webhook enabled and sends notifications whenever an event is triggered.
  11. Click Add webhook to complete the configuration of the webhook in GitHub Enterprise.