GitHub - Nango Docs

🚀 Quickstart

Connect to GitHub with Nango and see data flow in 2 minutes.

Create the integration

In Nango (free signup), go to Integrations -> Configure New Integration -> GitHub.

Authorize GitHub

Go to Connections -> Add Test Connection -> Authorize, then log in to GitHub. Later, you’ll let your users do the same directly from your app.

Call the GitHub API

Let’s make your first request to the GitHub API. Replace the placeholders below with your secret key, integration ID, and connection ID:

cURL
Node

curl "https://api.nango.dev/proxy/repos" \
  -H "Authorization: Bearer <NANGO-SECRET-KEY>" \
  -H "Provider-Config-Key: <INTEGRATION-ID>" \
  -H "Connection-Id: <CONNECTION-ID>"

Install Nango’s backend SDK with npm i @nangohq/node. Then run:

import { Nango } from '@nangohq/node';

const nango = new Nango({ secretKey: '<NANGO-SECRET-KEY>' });

const res = await nango.get({
    endpoint: '/repos',
    providerConfigKey: '<INTEGRATION-ID>',
    connectionId: '<CONNECTION-ID>'
});

console.log(res.data);

Or fetch credentials with the Node SDK or API.✅ You’re connected! Check the Logs tab in Nango to inspect requests.

Implement Nango in your app

Follow our Auth implementation guide to integrate Nango in your app.To obtain your own production credentials, follow the setup guide linked below.

📚 GitHub Integration Guides

Nango maintained guides for common use cases.

How to register your own GitHub OAuth app
Register an OAuth app with GitHub and obtain credentials to connect it to Nango

How to set up a GitHub App with Nango
Learn the differences between GitHub Apps and OAuth Apps, and how to configure a GitHub App in Nango

🧩 Pre-built syncs & actions for GitHub

Enable them in your dashboard. Extend and customize to fit your needs.

Files

Function name	Description	Type	Source code
`list-files`	Lists all the files of a Github repo given a specific branch	Sync	🔗 Github

Others

Function name	Description	Type	Source code
`commits`	Sync commits for repositories and branches in scope	Sync	🔗 Github
`issues`	Sync issues for one or more GitHub repositories with incremental updates based on issue activity	Sync	🔗 Github
`pull-requests`	Sync pull requests for one or more GitHub repositories, including status, branches, and merge state.	Sync	🔗 Github
`releases`	Sync releases for one or more GitHub repositories.	Sync	🔗 Github
`repositories`	Sync repositories visible to the authenticated GitHub user or installation.	Sync	🔗 Github
`repository-files`	Sync file metadata for a specific repository branch using the Git trees API recursively	Sync	🔗 Github
`workflow-runs`	Sync GitHub Actions workflow runs for one or more repositories.	Sync	🔗 Github

​🚀 Quickstart

​📚 GitHub Integration Guides

​🧩 Pre-built syncs & actions for GitHub

​Files

​Others

🚀 Quickstart

📚 GitHub Integration Guides

🧩 Pre-built syncs & actions for GitHub

Files

Others