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

# Connect GitHub Events

> Use the GitHub integration to capture deploys, PR merges, and releases as event markers in Costory.

Use the GitHub integration to capture deploys, PR merges, and releases.

<Steps>
  <Step title="Open Events setup">
    In Costory, go to <strong>Setup -> Events</strong>.
  </Step>

  <Step title="Connect GitHub">
    Click <strong>Connect GitHub</strong> to start the OAuth flow, then authorize the Costory GitHub App for the organization or repositories you want to track.
  </Step>

  <Step title="Approve permissions">
    Costory requests read-only access to repository metadata, pull requests, deployments, and releases. Webhooks are used to deliver events in near real time.
  </Step>
</Steps>

<Note>
  If your organization uses GitHub Enterprise, confirm that outbound webhooks can reach Costory and that the GitHub App is allowed by your org policy.
</Note>