Connect GitHub with a personal access token

In situations where you are not an admin of your GitHub repository, or otherwise do not have the necessary permissions to authenticate your GitHub account with LinearB, you can still connect by using GitHub personal access tokens.

Note that LinearB currently supports GitHub's Classic personal access tokens, not fine-grained tokens.

Create a personal access token in GitHub

GitHub describes how to create a personal access token within your GitHub user account. Click here to learn how to create a personal access token in GitHub

Grant the correct permissions

The personal access token will need the following options selected:

  • repo
  • read:org
  • read:user
  • user:email
  • read:discussion
  • admin:repo-hook

Add your GitHub token to LinearB

Once generated, paste your personal access token into LinearB's connect page. If you have not yet connected a Git account, you will be directed to this page upon logging in. If you have already connected a GitHub account, click on the gear icon in the top right of your page, select Company Settings, click on the Git tab, and click the Add Integration button. Paste in your token and LinearB will begin processing your GitHub data!

If you have any additional questions don't hesitate to reach out to us via email. You can also chat about anything Git or dev related if you join our Dev Interrupted Discord server!

How did we do?

Powered by HelpDocs (opens in a new tab)