> ## Documentation Index > Fetch the complete documentation index at: https://docs.stackone.com/llms.txt > Use this file to discover all available pages before exploring further. # GitHub GitHub App connector profile – StackOne setup guide > Set up the GitHub App connector profile for GitHub in StackOne. One-time admin setup required before your users can link GitHub accounts via Hub. Owner privileges in your GitHub organization or admin access to your GitHub account are required to create a GitHub App.
Select Actions to adjust the guide
Some actions may require additional configuration in the provider to be accessible. Choose the actions you need and the guide will be updated.
Action
Scope(s)
Loading actions...
Dynamic Guide URL
Scopes Selected

          

            
Separator

Creating a GitHub App

Create a GitHub App to enable OAuth 2.0 authentication with enhanced security and features.

Sign in to your GitHub account and navigate to developer settings.

  • Click your profile photo in the upper-right corner
  • Select Settings from the dropdown
  • In the left sidebar, scroll down and click Developer settings

Register a new GitHub App for StackOne integration.

  • In the left sidebar, click GitHub Apps
  • Click New GitHub App
  • Enter GitHub App name: StackOne Integration (or your preferred name)
  • Enter your website's Homepage URL (e.g., `https://stackone.com`)
  • Enter Callback URL: `https://api.stackone.com/connect/oauth2/github/callback`
  • Uncheck Request user authorization (OAuth) during installation
  • Check Expire user authorization tokens to enable refresh token support
  • Uncheck Active under Webhook
Enables actions: Add Collaborator, Add Team Member, Add Team Repository, Cancel Workflow Run, Check Organization Membership, Create Deployment, Create Deployment Status, Create Git Reference, Create Issue, Create Issue Comment, Create Or Update File, Create Organization Repository, Create Pull Request, Create Pull Request Review, Create Pull Request Review Comment, Create Release, Create Team, Create User Repository, Delete Deployment, Delete File, Delete Git Reference, Delete Release, Delete Repository, Delete Team, Download Artifact, Fork Repository, Get Authenticated User, Get Branch, Get Commit, Get Git Reference, Get Issue, Get Latest Release, Get Organization, Get Organization Membership, Get Pull Request, Get Repository, Get Repository Content, Get Team, Get Unified Credentials, Get Unified Group, Get Unified Organization, Get Unified Role, Get User, Get Workflow Run, Invite Organization Member, List Artifacts, List Authenticated User Organizations, List Authenticated User Repositories, List Branches, List Code Scanning Alerts, List Collaborators, List Commits, List Dependabot Alerts, List Deployments, List Forks, List Issue Comments, List Issues, List Matching Git References, List Organization Members, List Organization Repositories, List Pull Requests, List Releases, List Secret Scanning Alerts, List Teams, List Unified Groups, List Unified Organizations, List Unified Roles, List Unified Users, List User Organizations, List User Repositories, List Users, List Workflow Jobs, List Workflow Runs, Merge Pull Request, Re-run Workflow, Remove Collaborator, Remove Organization Member, Remove Team Member, Search Code, Search Issues, Search Repositories, Star Repository, Trigger Workflow, Unstar Repository, Update Code Scanning Alert, Update Dependabot Alert, Update Git Reference, Update Issue, Update Organization, Update Pull Request, Update Release, Update Repository, Update Secret Scanning Alert, Update Team, Update User, Upload Release Asset

Set the required permissions for your integration needs. GitHub Apps use fine-grained permissions instead of traditional OAuth scopes.

⚠️ IMPORTANT: These permissions are set here in the GitHub App configuration and CANNOT be changed during user authorization. Users will see these permissions when they authorize the app and can choose which repositories to grant access to.

Choose where the app can be installed.

  • Under Where can this GitHub App be installed?, select either Only on this account or Any account
  • Click Create GitHub App

After creation, you'll be redirected to your app's settings page.

  • Locate the Client ID field and copy its value.
  • Store this value securely for use later.

Generate a client secret for OAuth authentication.

  • Scroll to the Client secrets section
  • Click Generate a new client secret
  • Copy the displayed secret immediately and store it securely

Enable refresh token support for OAuth authentication.

  • Navigate to Optional features from the left sidebar menu
  • Click the Opt-in button corresponding to User-to-server token expiration. If it's already enabled, you should see the Opt-out button instead.

Install the GitHub App on your account or organisation for full access to private repositories, organisation data, and app-level permissions. This can be done before or after linking your account in StackOne. Without installation, only public repositories and user profile data are accessible.

  • Visit `https://github.com/settings/apps/{your-app-name}/installations` (replace `{your-app-name}` with your app slug) or navigate to your app's settings page, then Install App tab from sidebar.
  • Click on Install next to the account or organisation where you want to install the app
  • Choose All repositories or select specific repositories
  • Click Install button.
## Creating the StackOne Connector Profile To create the Connector Profile in StackOne for GitHub: Login to StackOne and navigate to [Connector Profiles](https://app.stackone.com/connector_profiles)
  • Click + Connector Profile
  • Search for and select GitHub
  • Select Type as GitHub App
  • Fill out the fields using details retrieved from your provider:
    • Client ID
    • Client Secret
  • (Optional) Select Actions to be enabled for this Connector Profile
  • Click Create profile
 Congratulations! The new Connector Profile will now show up in your project ready to be used. You can now continue to Link Accounts for GitHub.