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

# Setting up GitHub webhooks
DX [Onboarding](https://docs.getdx.com/onboarding/) uses pull request webhook events to track and measure ramp-up time. Configure a webhook in GitHub using your DX account's unique webhook endpoint URL.

## Step 1: Navigate to webhook settings

1. Go to your GitHub organization's webhook settings page:
   `/organizations/[your-org-name]/settings/hooks`
1. Click **Add webhook**. _Note: The webhook must be set up at the organization level, not on an individual repository._

## Step 2: Configure the webhook

1. Set **Payload URL** to your DX Onboarding webhook URL, found at [Onboarding setup](https://app.getdx.com/onboarding/setup).
2. Optionally, add your webhook secret.
3. Under **Which events would you like to trigger this webhook?**, select **Let me select individual events**.
4. Select only **Pull requests**. You may need to de-select **Pushes**, which is enabled by default.

## Step 3: Save and verify

Click **Add webhook**. If configured correctly, the "Install webhook" step will be marked as complete in DX.
---

## Sitemap

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