> ## Documentation Index
> Fetch the complete documentation index at: https://specterops-fetch-json-component.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Configure a Personal Access Token

> Create a Fine-grained Personal Access Token for GitHound data collection.

<img noZoom src="https://mintcdn.com/specterops-fetch-json-component/pkiaFEhjWYPnhxMb/assets/enterprise-AND-community-edition-pill-tag.svg?fit=max&auto=format&n=pkiaFEhjWYPnhxMb&q=85&s=c83d7e4a67c741a979c0e77bf15c1252" alt="Applies to BloodHound Enterprise and CE" width="482" height="45" data-path="assets/enterprise-AND-community-edition-pill-tag.svg" />

This page covers creating a Fine-grained Personal Access Token (PAT) for GitHound. PATs have a rate limit of **5,000 API requests per hour**.

<Tip>For higher rate limits, see [Configure a GitHub App Installation](/opengraph/extensions/githound/configure-app).</Tip>

## Create a Fine-grained Personal Access Token

1. Navigate to your GitHub **Profile** > **Settings**.

   <Frame>
     <img src="https://mintcdn.com/specterops-fetch-json-component/Aknesi2NwciziFMX/images/extensions/githound/pat/1_proile_settings.png?fit=max&auto=format&n=Aknesi2NwciziFMX&q=85&s=1c7de070d57487fa2d233b683153535d" alt="GitHub profile settings menu" width="344" height="751" data-path="images/extensions/githound/pat/1_proile_settings.png" />
   </Frame>

2. Go to **Developer settings** (bottom left).

   <Frame>
     <img src="https://mintcdn.com/specterops-fetch-json-component/Aknesi2NwciziFMX/images/extensions/githound/pat/2_developer_settings.png?fit=max&auto=format&n=Aknesi2NwciziFMX&q=85&s=ad6b2e0ab30491e4f63fb3a21a77564b" alt="Developer settings in GitHub profile" width="1300" height="1163" data-path="images/extensions/githound/pat/2_developer_settings.png" />
   </Frame>

3. Navigate to **Personal access tokens** > **Fine-grained tokens**.

   <Frame>
     <img src="https://mintcdn.com/specterops-fetch-json-component/Aknesi2NwciziFMX/images/extensions/githound/pat/3_fine-grained_tokens.png?fit=max&auto=format&n=Aknesi2NwciziFMX&q=85&s=7432479de62f5433bc169e250049ae61" alt="Fine-grained tokens in Developer settings" width="1135" height="196" data-path="images/extensions/githound/pat/3_fine-grained_tokens.png" />
   </Frame>

4. Click **Generate new token**.

   <Frame>
     <img src="https://mintcdn.com/specterops-fetch-json-component/Aknesi2NwciziFMX/images/extensions/githound/pat/4_generate_token.png?fit=max&auto=format&n=Aknesi2NwciziFMX&q=85&s=219a6c58d5a91d6738eddf405a7d2054" alt="Generate new fine-grained token page" width="1135" height="278" data-path="images/extensions/githound/pat/4_generate_token.png" />
   </Frame>

5. Set the **Resource owner** to your target organization.

6. Under **Repository access**, select **All repositories**.

   <Frame>
     <img src="https://mintcdn.com/specterops-fetch-json-component/Aknesi2NwciziFMX/images/extensions/githound/pat/5_all_repositories.png?fit=max&auto=format&n=Aknesi2NwciziFMX&q=85&s=dde531ce75761aa894a0845c3dedb27f" alt="Select All repositories for token access" width="1135" height="763" data-path="images/extensions/githound/pat/5_all_repositories.png" />
   </Frame>

7. Configure the required [repository and organization permissions](/opengraph/extensions/githound/collect-data#required-permissions) to **Read-only**.

   <Frame>
     <img src="https://mintcdn.com/specterops-fetch-json-component/Aknesi2NwciziFMX/images/extensions/githound/pat/6_permissions.png?fit=max&auto=format&n=Aknesi2NwciziFMX&q=85&s=f24f830f56006fb67421282c7e9206e9" alt="Token permissions configuration" width="803" height="325" data-path="images/extensions/githound/pat/6_permissions.png" />
   </Frame>

8. Click **Generate token** and copy the token value.

   <Frame>
     <img src="https://mintcdn.com/specterops-fetch-json-component/Aknesi2NwciziFMX/images/extensions/githound/pat/7_save_pat.png?fit=max&auto=format&n=Aknesi2NwciziFMX&q=85&s=4202ef9f75d6c6137b0a6c098fc5156b" alt="Copy the generated token" width="803" height="243" data-path="images/extensions/githound/pat/7_save_pat.png" />
   </Frame>

   <Warning>You must save the token value (preferably in a password manager) at this point. You will not be able to recover it later.</Warning>

   <Tip>For organizations with SAML SSO enabled, you must [authorize the PAT for SSO access](https://docs.github.com/en/enterprise-cloud@latest/authentication/authenticating-with-saml-single-sign-on/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on) after creating it.</Tip>

## Next Steps

After creating a token, proceed to [Running the Collector](/opengraph/extensions/githound/collect-data) to start collection.
