> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-bradley-turek-pfilter-operators-reference.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# 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](/s/article/360043438973).
## Generate a Token
Follow these steps on the [GitHub website](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens) 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.
