Skip to main content
Table of Contents

Installing a GitHub Organization-Level Webhook

LinearB uses webhooks to receive real-time notifications from customers' repositories and send real-time alerts to WorkerB users.

Steven Silverstone
Updated by Steven Silverstone

During onboarding, LinearB attempts to automatically install webhooks on all selected repositories. However, due to Git permissions, webhook installation may fail for some or all repositories.

If this occurs, LinearB admins can manually install webhooks for their entire GitHub organization.

Prerequisites

  • You must be a GitHub Organization Admin to install the webhook.
  • Contact support@linearb.io (or reach out to your CSM) to receive the necessary credentials:
    • Webhook URL
    • Secret Key

Step 1: Access Webhook Settings

  1. Log in to your GitHub Organization Admin account.
  2. Navigate to GitHub > Org Settings > Webhooks.
  3. Click Add Webhook.

Step 2: Configure Webhook Details

  1. In the Payload URL field, paste the Webhook URL provided by LinearB.
  2. Under Content Type, select application/json.
  3. In the Secret field, paste the Secret Key provided by LinearB.
  4. Enable SSL verification by checking the corresponding box.

Step 3: Select Events to Trigger the Webhook

  1. Under Which events would you like to trigger this webhook?, select Let me select individual events.
  2. Check the following events:
    • Check suites
    • Pull request review comments
    • Pull request reviews
    • Pull requests
    • Releases
  3. Click Save Webhook to complete the setup.

Verification

  • Once the webhook is added, GitHub will send a test ping event to verify the connection.
  • You can check webhook deliveries under Recent Deliveries in the webhook settings.

Need Assistance?

For further support, visit our Support Page or contact support@linearb.io.

How did we do?

GitLab Server (On-Prem) Connection Guide

Contact