Setting Up GitHub Integration with TeamScore

To connect TeamScore to your GitHub account, start by going to the TeamScore services page and selecting the option to connect to GitHub. You will then be redirected to the GitHub website, where you need to be logged in.

If you are an admin on any GitHub repositories, you will have the option to install the TeamScore application on GitHub. During installation, you can select which repositories TeamScore should have access to, or choose to allow visibility across all your repositories.

Once installed, TeamScore will receive notifications for activities happening on the connected GitHub repositories, such as commits, pull requests, and comments.

Important User Mapping Step

After installation, you will be redirected back to TeamScore where you will see the Users tab. This step is crucial because GitHub identifies users by their GitHub username instead of their email address, which differs from some other integrations.

Since usernames on GitHub may not be obvious or linked to a user’s email (especially for contractors or external contributors), you need to manually map your TeamScore users to their corresponding GitHub usernames. This one-time mapping ensures that commits, pull requests, and comments are properly attributed in TeamScore for each user.

If this mapping is not done, activities from GitHub will not show up correctly under the respective TeamScore user because the identifiers will not be connected.

TeamScore attempts to auto-map users where possible, but manual verification and mapping usually produces the best and clearest results.