GitHub Connector

Prerequisites

• A GitHub account with access to the repositories you want to sync
• Organization Owner or Admin access (if syncing organization repos)

Authentication

GitHub uses the Landed GitHub App for authentication. This provides granular, per-repository access without sharing personal tokens.

Step 1: Install the Landed GitHub App

1. In Landed, click Add Connector and select GitHub
2. Click Connect to GitHub
3. You will be redirected to GitHub to install the Landed app
4. Choose which account or organization to install it on
5. Select repositories:
   • All repositories: grants access to all current and future repos
   • Only select repositories: choose specific repos to sync
6. Click Install (or Install & Authorize)
7. You will be redirected back to Landed

Step 2: Select Repositories

After installing the app, choose which repositories to sync in the Landed connector configuration.

Modifying Access Later

To add or remove repository access after initial setup:

1. Go to GitHub > Settings > Applications > Installed GitHub Apps
2. Click Configure next to the Landed app
3. Modify the repository selection
4. Click Save

Changes take effect on the next sync.

Required Permissions

The Landed GitHub App requests these permissions:

Permission	Access	Purpose
Repository contents	Read	Sync commits, branches, files
Issues	Read	Sync issues and issue comments
Pull requests	Read	Sync pull requests and PR reviews
Metadata	Read	Basic repository information

The app only receives read access. It cannot modify your repositories.

Available Streams

Stream	Description	Sync Mode
repos	Repository metadata	Full refresh
commits	Commit history	Incremental
pull_requests	Pull request records	Incremental
issues	Issue records	Incremental
issue_comments	Comments on issues	Incremental
pull_request_reviews	PR review records	Incremental
stargazers	Users who starred the repo	Full refresh
collaborators	Repository collaborators	Full refresh

Common Errors

Error	Cause	Fix
401 Bad credentials	App installation revoked	Reinstall the GitHub App
403 Resource not accessible	App doesn't have access to the repo	Add the repo in GitHub App settings
404 Not Found	Repository deleted or made private	Verify the repo exists and the app has access
Rate limit exceeded	GitHub API rate limit hit	Landed handles rate limiting automatically (5,000 requests/hour for apps)

Data Notes

• GitHub App installations have a rate limit of 5,000 requests per hour per installation
• Commit data includes author, committer, message, and file changes
• Landed syncs data from the default branch by default