---
title: "Setting up GitLab webhooks"
canonical_url: "https://docs.getdx.com/onboarding/gitlab-webhooks/"
md_url: "https://docs.getdx.com/onboarding/gitlab-webhooks.md"
last_updated: "2026-05-08"
---

# Setting up GitLab webhooks
DX [Onboarding](https://docs.getdx.com/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`
1. 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](https://app.getdx.com/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.
---

## Sitemap

[Overview of all docs pages](/llms.txt)