Configuring webhooks in GitLab

You can configure a webhook to link work items to Git commits.


  1. In the web client, log on to Change and Configuration Management. For example, go to https://host_name:9443/ccm/web.
  2. On the CCM project page, click Source Control > Work with Git.
  3. Click Browse Registered Git Repositories.
  4. Select the repository that you registered.
  5. Expand the Host Server Configuration section.
  6. In the Hosting Server field, select GitLab.
  7. In the Secret Key Authorization field, add a secret. The secret is provided when you configure the webhook in GitLab.
  8. Click the Copy button next to the webhook URL.
  9. Optional: If GitLab and Engineering Workflow Management do not share a user base, add a functional user ID for the webhook URL.
    1. Click Insert Functional User.
    2. Select the user and click OK. Click the Copy button next to the webhook URL.
    3. Click Add Webhook.
  10. Click Save to persist the changes to the Git Repository Registration page in IBM® Engineering Workflow Management.
  11. In your GitLab project web UI, open the integrations page of your project.
  12. To add the webhook URL to the GitLab repository, follow the instructions in Webhooks.
  13. Under the Trigger section, select the Push event.
  14. In the Secret Token field, enter the value that you entered in the Secret Key Authorization field.
  15. In the Webhook URL field, paste the web hook URL that you copied in step 8.
  16. Click Save to the webhook configuration in GitLab.

What to do next

After you configure a webhook, validate it.