> ## Documentation Index
> Fetch the complete documentation index at: https://nango-tiktok-accounts-update.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# GitHub

API configuration: [`github`](https://nango.dev/providers.yaml), [`github-app`](https://nango.dev/providers.yaml), [`github-app-oauth`](https://nango.dev/providers.yaml)

## Features

| Feature                                                                                                                                                | Status                        |
| ------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------- |
| Auth ([OAuth](/guides/oauth) and [App](https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/differences-between-github-apps-and-oauth-apps)) | ✅                             |
| [Syncs](/guides/sync) & [Actions](/guides/action)                                                                                                      | ✅                             |
| [Nango Proxy](/guides/proxy)                                                                                                                           | ✅                             |
| [Integration templates](/integration-templates/overview)                                                                                               | ✅                             |
| Auto-pagination                                                                                                                                        | 🚫 (time to contribute: \<1h) |
| API-specific rate limits                                                                                                                               | 🚫 (time to contribute: \<1h) |

<Tip>We can implement missing features in \<48h, just ask for it in the [community](https://nango.dev/slack).</Tip>

## Getting started

* [Difference between OAuth Apps and GitHub Apps](https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/differences-between-github-apps-and-oauth-apps)
* [How to register a GitHub App](https://docs.github.com/en/apps/creating-github-apps/registering-a-github-app/registering-a-github-app)
* [How to register an OAuth App](https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/creating-an-oauth-app)
* [List of GitHub App permissions](https://docs.github.com/en/rest/overview/permissions-required-for-github-apps)
* [List of OAuth scopes](https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/scopes-for-oauth-apps#available-scopes)
* [OAuth-related docs](https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/authorizing-oauth-apps)

<Tip>Need help getting started? Get help in the [community](https://nango.dev/slack).</Tip>

## API gotchas

* When setting up a GitHub App:
  * The App ID is made of numbers (e.g. 401953)
  * The App Public Link is the URL to your Github App public page (e.g. [https://github.com/apps/nango-github-app](https://github.com/apps/nango-github-app))
  * The App Private Key needs to be generated in your GitHub App settings and starts with `-----BEGIN RSA PRIVATE KEY-----` (not to be confused with the Client Secrets)
  * The Setup URL (displayed on your Nango integration page) needs to be added to your GitHub App configuration (not to be confused with the Callback URL that can stay empty)
* There are certain API methods that only work with an OAuth App that will not work with an App. Please check the Github documentation and look for a "Works with Github Apps" header under the endpoint.
* The `github-app-oauth` is a combination of a Github App and OAuth and should be used when a Github App would need approval to be installed into an organization.
* Nango supports initiating a connection with a GitHub App using the [Frontend SDK](https://docs.nango.dev/sdks/frontend#collecting-and-storing-end-user-credentials), but not directly from the [GitHub Marketplace](https://github.com/marketplace). Therefore, you should encourage users to install your GitHub App from your product, rather than from the GitHub Marketplace directly. This is a limitation we plan to fix in the future.

<Note>Add Getting Started links and Gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs-v2/integrations/all/github.mdx)</Note>