> ## Documentation Index
> Fetch the complete documentation index at: https://bobprince.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# GitHub

> Capture GitHub webhook events with Hookdrop

## Setup

<Steps>
  <Step title="Open Webhooks settings">
    Go to your GitHub repository, then navigate to **Settings → Webhooks**.
  </Step>

  <Step title="Add a webhook">
    Click **Add webhook**.
  </Step>

  <Step title="Paste your Hookdrop URL">
    Enter your Hookdrop capture URL in the **Payload URL** field:

    ```
    https://hookdrop.dev/in/{your-token}
    ```
  </Step>

  <Step title="Set the content type">
    Set **Content type** to `application/json`.
  </Step>

  <Step title="Select events">
    Choose **Let me select individual events** and pick the events you want to capture, or select **Send me everything** to capture all activity.
  </Step>

  <Step title="Save">
    Click **Add webhook**. GitHub will deliver a `ping` event right away to confirm the endpoint is reachable.
  </Step>
</Steps>

<Note>
  GitHub fires a `ping` event as soon as you register a webhook. You'll see it appear in Hookdrop within seconds — a quick way to confirm everything is connected.
</Note>

## Common events

| Event          | When it fires                     |
| -------------- | --------------------------------- |
| `push`         | Code pushed to a branch           |
| `pull_request` | PR opened, closed, or merged      |
| `issues`       | Issue opened or closed            |
| `workflow_run` | GitHub Actions workflow completed |
| `release`      | New release published             |

## Debugging CI/CD events

<Tip>
  Point your GitHub Actions webhook at a Hookdrop URL to inspect `workflow_run` and `check_run` payloads. This makes it easy to see exactly what data GitHub sends after each CI run without having to deploy a receiver.
</Tip>