GitHub Setup Guide

Follow our setup guide to connect GitHub to Fivetran.

---

Prerequisites

To connect GitHub to Fivetran, you need access to an active GitHub account with the permissions appropriate for the following GitHub scopes:

• repo
• read:org
• admin:org_hook
• admin:repo_hook

See the for details.

If you use , grant the following permissions:

• Administration:read

• Issues:read

• Members:read

• Metadata:read

• Pull requests:read

• Organization projects:read

• Repository projects:read

  • To sync the RELEASE table, grant Contents:read permission

  • To sync the DEPLOYMENT table, grant Deployments:read permission

  • To use webhooks to sync your data, grant Organization hooks:write and Repository hooks:write permissions

NOTE: Fine-grained tokens don't provide permissions to sync repository-level projects. In this case, you must disable the CARD, COLUMN, and PROJECT tables on the schema tab.

IMPORTANT: Only use an HTTPS URL with TLS version 1.2 or above.

---

Setup instructions

1. In the , enter your chosen destination schema name.

2. Select the authentication mode: OAuth or Personal Access Token.

   • If you choose OAuth:

     a. Click Authorize to authorize Fivetran to connect to your GitHub account. You will be redirected to GitHub.

     b. In GitHub, click authorize Fivetran and enter your password when prompted. You will be redirected to the connector setup form.

   • If you choose Personal Access Token:

     a. Create the on behalf of several different GitHub users.

     b. Enter the Personal Access Tokens in the setup form.

     c. Click Validate Personal Access Tokens.

     NOTE: GitHub sets a on the number of requests per hour from one user. We recommend specifying 4-5 personal access tokens to avoid exceeding this request rate limit and make the sync much more efficient.

3. Choose the sync mode: Sync All Repositories or Sync Specific Repositories.

4. If you choose Sync Specific Repositories, select the accounts you'd like to sync.

5. If you want to use webhooks, set the Use Webhooks toggle to ON.

6. Click Save & Test. Fivetran will take it from here and sync your GitHub data.

---

Related articles