GitHub Setup Guide link
Follow our setup guide to connect GitHub to Fivetran.
Prerequisiteslink
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 GitHub Scopes For OAuth Apps documentation for details.
If you use fine-grained personal access tokens, 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, grantContents:read
permissionTo sync the
DEPLOYMENT
table, grantDeployments:read
permissionTo use webhooks to sync your data, grant
Organization hooks:write
andRepository 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
, andPROJECT
tables on the schema tab.
IMPORTANT: Only use an HTTPS URL with TLS version 1.2 or above.
Setup instructionslink
In the connector setup form, enter your chosen destination schema name.
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 Personal access tokens on behalf of several different GitHub users.
b. Enter the Personal Access Tokens in the setup form.
c. Click Validate Personal Access Tokens.
IMPORTANT: GitHub sets a rate limit on the number of requests per hour from one user. You can work around this limitation in one of the following ways:
- Use multiple accounts to create personal access tokens, with each token created by a different account. Specify 4-5 personal access tokens to avoid exceeding the request rate limit and make the sync more efficient.
- Use multiple accounts with OAuth2 authentication. Create separate Fivetran connectors for each account, then distribute syncing tasks across these connectors to leverage multiple API quotas.
Choose the sync mode: Sync All Repositories or Sync Specific Repositories.
If you choose Sync Specific Repositories, select the accounts you'd like to sync.
If you want to use webhooks, set the Use Webhooks toggle to ON.
Click Save & Test. Fivetran will take it from here and sync your GitHub data.
Related articleslink
description Connector Overview
account_tree Schema Information
settings API Connector Configuration