> For the complete documentation index, see [llms.txt](https://developer.harness.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.harness.io/ai-sre/ai-sre-for-administrators/set-up-change-management/sources/github.md).

# Configure GitHub for pull request ingestion

Connect GitHub as a source-control change source so the [Deploy Change Investigator](/ai-sre/ai-sre-for-administrators/set-up-change-management/deploy-change-investigator.md) ingests the pull requests merged into your deploy branch and links them to builds and deployments.

### Before you begin <a href="#before-you-begin" id="before-you-begin"></a>

* **Deploy Change Investigator setup:** Build and deploy webhook integrations created in AI SRE. Go to [Deploy Change Investigator](/ai-sre/ai-sre-for-administrators/set-up-change-management/deploy-change-investigator.md) to set up the webhook endpoints.
* **A GitHub connector:** A Harness GitHub connector configured in your project. Go to [Connect to a code repo](/harness-ai/use-harness-platform/connectors/code-repositories/connect-to-code-repo.md) to create one.
* **Connector permissions:** Account, organization, or project **Admin**, or a role with **Manage Connectors**, to create a connector. Go to the [permissions reference](/harness-ai/use-harness-platform/platform-access-control/permissions-reference.md) to review required permissions.

***

### How GitHub pull request ingestion works <a href="#how-github-pull-request-ingestion-works" id="how-github-pull-request-ingestion-works"></a>

The Deploy Change Investigator ingests GitHub pull requests by **polling**, not through webhooks. You do not paste a webhook URL into GitHub. Instead, AI SRE uses your GitHub connector to periodically query the GitHub API for pull requests that have merged into your deploy branch.

* **Mechanism:** AI SRE polls the GitHub REST API for closed and merged pull requests on the tracked repository.
* **Frequency:** The ingestion job runs approximately once per hour.
* **Lookback:** On first activation, the job backfills merged pull requests from the previous 60 days when it is created automatically from a build webhook, or 90 days when you create it manually. It then syncs incrementally.
* **Stored data:** Each pull request is stored with its branch, PR number, commit SHA, title, merge timestamp, and author.

{% hint style="info" %}
**POLLING, NOT WEBHOOKS**

Unlike the CI/CD build and deploy integrations, source-control change sources do not require a webhook. There is nothing to configure inside GitHub beyond the access granted to your Harness connector.
{% endhint %}

***

### Supported GitHub platforms <a href="#supported-github-platforms" id="supported-github-platforms"></a>

| Platform                 | Supported |
| ------------------------ | --------- |
| GitHub.com               | Yes       |
| GitHub Enterprise Cloud  | Yes       |
| GitHub Enterprise Server | Yes       |

Authentication uses your GitHub connector's credentials, either a personal access token (PAT) or a GitHub App. Go to [GitHub App support](/harness-ai/use-harness-platform/connectors/code-repositories/git-hub-app-support.md) to configure a GitHub App connector, or go to the [GitHub connector settings reference](/harness-ai/use-harness-platform/connectors/code-repositories/ref-source-repo-provider/git-hub-connector-settings-reference.md) to review connector fields.

***

### Select the connector for AI SRE <a href="#select-the-connector-for-ai-sre" id="select-the-connector-for-ai-sre"></a>

Map the GitHub source to a connector so AI SRE knows which credentials to use.

1. In the left navigation, click **Project Settings** (gear icon).
2. Under **Project-level resources**, select **Third Party Integrations (AI SRE)**.
3. On the **Third-Party Integrations for AI SRE** page, find the **Github** row.
4. Select your GitHub connector from the dropdown. The scope tag (for example, **PROJECT**) shows where the connector is defined.

![Third-Party Integrations for AI SRE page with a connector selected for each source, including Github](/files/vczQSxX6uW5vAH7PthKq)

{% hint style="info" %}
**PROJECT-SCOPED PAGE**

This page is scoped to the project shown in the **PROJECT** selector at the top of the left navigation. Confirm the correct project is selected before you map connectors.
{% endhint %}

***

### Create a pull request ingestion <a href="#create-a-pull-request-ingestion" id="create-a-pull-request-ingestion"></a>

Create the ingestion job manually if you do not want to wait for automatic creation from a build webhook:

1. In the AI SRE left navigation, go to **Integrations**.
2. Open the **PR Ingestions** tab.
3. Click **+ New PR Ingestion**.
4. In the **Create New PR Ingestion** dialog, under **Select Git Provider**, choose **GitHub**.
5. Enter the **Repository URL** of the repository to track.
6. Click **Create**.

![Create New PR Ingestion dialog with GitHub selected as the Git provider and a repository URL field](/files/uZEUpTGB0K5kmDjPAMod)

{% hint style="info" %}
**AUTOMATIC CREATION FROM BUILD WEBHOOKS**

You do not have to create the ingestion by hand. When you send your first build webhook that includes a `source.repository_url` pointing at a GitHub repository, AI SRE creates the pull request ingestion job automatically.
{% endhint %}

***

### Verify pull request ingestion <a href="#verify-pull-request-ingestion" id="verify-pull-request-ingestion"></a>

Confirm the ingestion job is running and syncing pull requests:

1. In the AI SRE left navigation, go to **PR Ingestions** (tab next to Integrations).
2. Confirm an ingestion job exists for your repository with:
   * Repository name
   * Branch being tracked (usually `main`)
   * Last sync status and timestamp
3. After the next hourly sync, confirm merged pull requests appear against your deployments in **Change Management**.

***

### Troubleshooting <a href="#troubleshooting" id="troubleshooting"></a>

<details>

<summary>GitHub pull request ingestion job not created after sending build webhooks</summary>

Confirm a GitHub connector exists at Project Settings > Connectors, that the Github row is mapped to it under Project Settings > Third Party Integrations (AI SRE), and that your build webhook payload includes the source.repository\_url field. AI SRE creates the ingestion job on the first build webhook that identifies a repository. You can also create it manually under Integrations > PR Ingestions > New PR Ingestion.

</details>

<details>

<summary>GitHub pull request ingestion job created but no PRs are syncing</summary>

Confirm the connector has read access to the repository, the tracked branch matches your actual deploy branch, and pull requests have merged into that branch within the lookback window. Open the job details for specific error messages.

</details>

<details>

<summary>GitHub Enterprise Server pull requests are not ingested</summary>

Confirm the GitHub connector points at your GitHub Enterprise Server URL and that the Harness Delegate or Platform can reach that host over HTTPS. Network egress or an incorrect base URL is the usual cause.

</details>

***

### Next steps <a href="#next-steps" id="next-steps"></a>

* Go to [Deploy Change Investigator](/ai-sre/ai-sre-for-administrators/set-up-change-management/deploy-change-investigator.md) for the complete setup guide.
* Go to [Configure Bitbucket](/ai-sre/ai-sre-for-administrators/set-up-change-management/sources/bitbucket.md) to add Bitbucket as a source-control change source.
* Go to [AI Agent RCA](/ai-sre/ai-sre-for-incident-responders/use-ai-agents/rca-change-agent.md) to learn how change detection works during incidents.