- Setup
- Reference
What You'll Need
| Credential | Description |
|---|---|
| API Token | Fine-grained personal access token |
| Organization | Your GitHub organization name |
Overview
GitHub fine-grained personal access tokens provide granular, organization-scoped access to your repositories and organization data.Repositories
Commits, branches, pull requests, issues
Organization
Members, teams, projects, events
Prerequisites
- Admin access to the GitHub organization
- A GitHub account that is a member of the organization with admin privileges
Setup Guide
1
Access Developer Settings
- Log in to GitHub
- Click your profile picture → Settings
- Scroll to the bottom → Developer settings
2
Create Fine-Grained Token
- Select Personal access tokens → Fine-grained tokens
- Click Generate new token
- If you have 2FA enabled, enter your code
3
Configure Token Settings
| Setting | Value |
|---|---|
| Token name | Parable GitHub Integration |
| Description | Integration for Parable analytics |
| Resource owner | Select your organization |
| Expiration | 360 days (recommended) |
| Repository access | All repositories (or select specific) |
4
Set Organization Permissions
Under Organization permissions, set these to Read:
- ✅ Members
- ✅ Organization administration
- ✅ Organization events
- ✅ Organization projects
- ✅ Team discussions
5
Set Repository Permissions
Under Repository permissions, set these to Read:
- ✅ Pull requests
- ✅ Issues
- ✅ Discussions
- ✅ Commit statuses
- ✅ Contents
- ✅ Code (if available)
- ✅ Metadata
6
Generate and Save
- Click Generate token
- Copy the token immediately