Setting up GitHub webhooks

DX 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
  2. 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.
  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.