Skip to main content

Setting up GitLab webhooks

Updated this week

DX docs are moving! Visit docs.getdx.com for all current and future help—this page will no longer be updated.

DX onboarding uses merge request webook events to track and measure ramp-up time. You'll configure a webhook in GitLab using your DX account's unique webhook endpoint URL.

Setup instructions

1. Go to your GitLab group's webhook settings page and click "Add new webhook".

(/groups/[GitLab group name]/-/hooks)

⚠️ The webhook must be set up at the group level – not on a project.

2. Use your DX Onboarding webhook URL as the URL. Next, enable "Merge request events". Finally, click "Add webhook" to save.

3. To make sure everything is set up correctly, send a test using "Merge request events". If successful, you should see the "Install webhook" step marked as complete in DX.

Did this answer your question?