Setting up GitLab webhooks

DX Onboarding uses merge request webhook events to track and measure ramp-up time. Configure a webhook in GitLab using your DX account’s unique webhook endpoint URL.

Step 1: Navigate to webhook settings

  1. Go to your GitLab group’s webhook settings page:
    /groups/[your-group-name]/-/hooks
  2. Click Add new webhook. Note: The webhook must be set up at the group level, not on an individual project.

Step 2: Configure the webhook

  1. Set URL to your DX Onboarding webhook URL, found in Onboarding setup.
  2. Under Trigger, select the following events:
    • Merge request events (required)
    • Comments (required for real-time review data)

Step 3: Save and verify

  1. Click Add webhook to save.
  2. Send a test using Merge request events to verify.

If configured correctly, the “Install webhook” step will be marked as complete in DX.