GitHub Connector

Intro

This article explains how to generate a personal access token to connect GitHub to Domo Documents. For a personal GitHub connection, follow the OAuth prompts. For an Enterprise connection, follow the steps below to generate a token.

---

Required Grants

To access Documents, the following grants must be enabled for your role:

• Manage Documents — View, edit, and delete any Document Collections in this instance.
• Edit Documents — Create and edit Document Collections to which you have access.
• View Documents — View only for any Document Collections to which you have access.

Learn more about grants.

Generate a Token

Follow these steps on the GitHub website to create a new token:

1. Select your profile picture in the top-right corner of any GitHub page, then select Settings.

2. Scroll to the bottom of the left sidebar and select Developer settings.

3. Expand the Personal access tokens menu and select either Fine-grained tokens or Tokens (classic).

4. Select Generate new token.

5. Configure the token details:

   • Enter a descriptive Token name or note.
   • Set an Expiration period. Domo recommends setting an expiration for security.
   • Choose the Resource owner and specific Repository access (for fine-grained tokens).

6. Under Permissions or Scopes, select the boxes matching your requirements.

   Note: For repository management such as pushing and pulling, you must select the repo scope or read/write repository permissions.

7. Scroll to the bottom and select Generate token.

Important: Copy your token immediately and save it in a password manager. GitHub does not display the token again after you navigate away from the page.