Skip to main content

GitHub integration

Authentication​

Supported authentication methods​

Personal token​

Before using this method, please ensure you have the proper personal token. To generate it, navigate to GitHub personal access tokens. The following scopes must be selected for the token: repo, repo:status, public_repo, read:org, project.

Select "Personal token" in the first step of integration wizard. Click "Next".

Select personal token authentication

Paste the personal access token you just generated.

Provide authentication info

OAuth​

Select "OAuth" in the first step of integration wizard. Click Next.

Select OAuth

You will be presented with dialog asking you to authorize Bugsee. Click Authorize to allow Bugsee access your GitHub.

OAuth Grant

Configuration​

After authentication, you will be presented with the following dialog with the request to choose strategy. Strategies include: Repository, Projects with issues, Projects with drafts. Please see the details for each strategy below.

Strategy: Repository​

With this strategy all issues will be created in the repository you map to the application at the last step of the wizard.

OAuth Grant

For custom fields you can use in custom recipes, refer to GitHub documentation for the issue object.

Strategy: Project with issues​

With this strategy all issues will be created in the repository selected in this step and they will also be added to the mapped project at the last step of the wizard (as an issue item). Note, that the projects to map in the last step will be fetched from the repository selected in this step.

OAuth Grant

For custom fields you can use in custom recipes, refer to GitHub documentation for the issue object.

Strategy: Project with drafts​

With this strategy no issues are created in the repository, but rather they are added as drafts to the mapped project at the last step of the wizard. These draft items can later be converted to issues manually in GitHub. Note, that the projects to map in the last step will be fetched from the repository selected in this step.

OAuth Grant

For custom fields you can use in custom recipes, refer to GitHub documentation for the draft item.

Custom recipes​

Bugsee can accommodate all these customizations with the help of custom recipes. This section provides a few examples of using custom recipes specifically with GitHub. For basic introduction, refer to custom recipe documentation.

Setting labels field​

By default Bugsee creates and updates GitHub issues with Bugsee issue labels. But labels list can be overridden inside your custom recipe. For example you can add some new label to existing ones:

function create(context) {
	// ....

    return {
    	// ...
    	labels: [...issue.labels, "My awesome label"]
    };
}

function update(context, changes) {
	const result = {};
	// ...
    
    if (changes.labels) {
        result.labels = [...changes.labels.to, "My awesome label"];
    }

	return {
        issue: {
            custom: {}
        },
        changes: result
    };
}
Found an issue, typo, or wrong statement on this page? Report it now →