GitHub is a widely used development platform. The Kualitee-GitHub two-way integration allows you to sync your issues between both tools. Each GitHub project can be linked with a Kualitee project to sync all the reported issues that exist in both projects. Since it’s a two-way integration, all updates that are made on the issue will automatically get synced, including a change in status, additional comments, and associations changed through Kualitee. 

Create Integration 

To configure the two-way integration between Kualitee and GitHub, you need admin access on the tools. The integration is basic, with hard-coded field to field mapping. 

• Go to Settings and select Integration from the top bar 
• Go to ‘Create New’ in the external tool integration listing 
• Select GitHub tool from the drop-down menu 
• Enter the Personal Access Token of your GitHub account 

Click ‘Save’ button to confirm a successful integration and to start syncing issues. 
 

You can also edit the integration, as shown below.  

The basic mapping is a hard-coded field to field mapping between Kualitee and GitHub. Below is a table that shows the mapping for each field. 

GitHub token generation steps:

Navigate to: https://github.com/settings/tokens

Click on generate new token (Classic)

Enter token name or any information in the “note” field

Set the expiry date of token

Select the scope of token as shown in below image, and click on ‘generate token’ button

To integrate on Kualitee:

Go to Kualitee -> Settings -> Integrations

Click on ‘Create Integration’

Select GitHub as tool from the drop down menu

Copy the token in Personal Access token field

Click on the ‘edit’ icon and navigate to the Project Mapping screen

Click on ‘Map Project’ button

Select the integration type as ‘basic’

Select the organization that you want to map (if you want to map repository integrated from organization)

Select GitHub repository

Select labels (If you select the labels only, the labeled defects will be pulled from GitHub)

Select the Kualitee project with which you want to map

Click on the ‘Save’ button to save the integration