Files
n8n-docs/docs/integrations/builtin/credentials/github.md

2.8 KiB

title, description, contentType
title description contentType
GitHub credentials Documentation for GitHub credentials. Use these credentials to authenticate GitHub in n8n, a workflow automation platform. integration

GitHub credentials

You can use these credentials to authenticate the following nodes:

Prerequisites

Create a GitHub{:target=_blank .external-link} account.

Supported authentication methods

  • API access token
  • OAuth2

Refer to GitHub's API documentation{:target=_blank .external-link} for more information about the service.

Using API access token

To configure this credential, you'll need:

  • The URL for a GitHub server:
    • If you are not using GitHub Enterprise Server, keep the URL that n8n has prepopulated.
    • If you're using GitHub Enterprise Server{:target=_blank .external-link}, update this field to match the URL for your server.
  • A User name: Your username as it appears in your GitHub profile
  • An Access Token: n8n recommends using a personal access token (classic), since GitHub's fine-grained personal access tokens are still in beta and cannot access all endpoints. Refer to Creating a personal access token (classic){:target=_blank .external-link} and Creating a fine-grained personal access token{:target=_blank .external-link} for detailed steps on generating a new access token.

Using OAuth2

--8<-- "_snippets/integrations/builtin/credentials/cloud-oauth-button.md"

If you need to configure OAuth2 from scratch or need more detail on what's happening in the OAuth web flow, you'll need to register a new OAuth app{:target=_blank .external-link}. Refer to that documentation for detailed instructions on creating a new app, and refer to the GitHub Authorizing OAuth apps documentation{:target=_blank .external-link} for more information on the authorization process.