GitHub App

🚀 Quickstart

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

Create an integration

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

Nango has a Nango-managed app you can use in development and production. Select it when you create the integration.

Authorize GitHub App

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 (lists all public repositories in the order that they were created). Replace the placeholders below with your Environment API key, integration ID, and connection ID:

cURL
Node

curl "https://api.nango.dev/proxy/repositories" \
  -H "Authorization: Bearer <NANGO-API-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({ apiKey: '<NANGO-API-KEY>' });

const res = await nango.get({
    endpoint: '/repositories',
    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 use your own app instead of the Nango-managed one, follow the setup guide linked below.

📚 GitHub App Integration Guides

Nango maintained guides for common use cases.

How to register your own GitHub App
Register a GitHub App and obtain credentials to connect it to Nango

Official docs: GitHub Developer Documentation

🧩 Pre-built syncs & tools for GitHub App

Explore Nango-provided tools in your dashboard. Extend and customize them to fit your needs.

Commits

Function name	Description	Type
`commits`	Get all pull commits from a Github repository.	Sync

Pull Requests

Function name	Description	Type
`pull-requests`	Get all pull requests from a Github repository.	Sync

Others

Function name	Description	Type
`repositories`	List all repositories accessible to this Github App	Tool
`search-code`	Search file contents across indexed GitHub repositories using code-search qualifiers.	Tool
`search-commits`	Search commits across indexed repositories by message, author, or metadata qualifiers.	Tool
`search-issues-and-pull-requests`	Search issues and pull requests across indexed repositories using GitHub’s issue-search qualifiers.	Tool
`search-labels`	Search for labels within a specific repository by name or description.	Tool
`search-repositories`	Search public and accessible repositories using GitHub’s repository-search qualifiers.	Tool
`search-topics`	Search GitHub topics (the tagging/categorization objects behind repository topic pages).	Tool
`search-users`	Search GitHub user and organization accounts using user-search qualifiers.	Tool

Overview

1,000+ APIs & Integrations

🚀 Quickstart

📚 GitHub App Integration Guides

🧩 Pre-built syncs & tools for GitHub App

Commits

Pull Requests

Others

​🚀 Quickstart

​📚 GitHub App Integration Guides

​🧩 Pre-built syncs & tools for GitHub App

​Commits

​Pull Requests

​Others

🚀 Quickstart

📚 GitHub App Integration Guides

🧩 Pre-built syncs & tools for GitHub App

Commits

Pull Requests

Others