All Collections
Authentication Guides
Ticketing
Github - How do I link my account?
Github - How do I link my account?

How to link your Github account to Merge

Matthew Ho avatar
Written by Matthew Ho
Updated over a week ago

Overview

To authenticate Github, you will need to provide the following information:

  • Github username

  • Github access token

This guide will walk you through finding or creating those credentials within Github.

Instructions

Step 1: Go to settings

  1. In the upper-right corner of any page, click your profile photo

  2. Click Settings

Step 2: Generate a new token

  1. In the left sidebar, click Developer Settings

  2. Under Personal access tokens, click Tokens (classic)

  3. Select Generate new token, then click Generate new token (classic)

  4. In the "Note" field, give your token a descriptive name

To give your token an expiration, select Expiration, then choose No Expiration

Step 3: Select scopes

  1. admin > read:org — To read org & team membership, read org projects

  2. admin:repo_hook — To create & read webhooks

  3. admin:org_hook — To create & read webhooks

  4. user:read:user — To read all user profile data

  5. user:email — To read all user emails

  6. read:enterprise — To read enterprise profile data

  7. read:audit_log — To read audit log

  8. read:project — To read projects

Step 3 (Optional): Enable SAML SSO

If your Github organization is Enterprise and you have SAML SSO enabled, it is recommended to also enable SSO for your personal access token following instructions here for a deeper integration of Github users!


Step 4: Enter the token in the linking flow

Back in the linking flow, enter your username and token

Did this answer your question?