Skip to content
API reference Go to app

Configure GitHub Issues

1 min read

GitHub Issues integrations let Hawzu create and link GitHub issues from defects.


Prepare a Personal Access Token from GitHub settings.

The setup window explains that the token needs repository access for issues. Use a token that can reach the repositories where Hawzu should create issues.


  1. Open the workspace Integrations page.
  2. Select Add Integration.
  3. Search for GitHub Issues and select it.
  4. Add an optional integration name and description.
  5. Choose All Projects or Selected Projects.

Use selected projects when only some Hawzu projects should create or link GitHub issues.


Enter the GitHub personal access token and select Test Connection.

If the connection fails, review the token, repository access, and token permissions before trying again.


After a successful connection, choose the GitHub defaults used when Hawzu creates external issues from defects:

  • Default Repository
  • Default Labels, when available

The repository controls where new GitHub issues are created. Labels help route new issues into the right GitHub workflow.


Save is available after the connection succeeds and the required GitHub repository is selected.

After saving, GitHub Issues appears in the Integrations table with its status, project scope, and configuration details. Users with access can create GitHub issues from Hawzu defects and link existing GitHub issues.