Skip to content
API reference Go to app

Configure GitLab Issues

1 min read

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


Prepare these GitLab details:

  • GitLab Instance URL, such as https://gitlab.com
  • Personal Access Token

The setup window explains that the token needs issue access through GitLab permissions. Use a token that can reach the GitLab projects where Hawzu should create issues.


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

Project scope controls where the GitLab connection is available in Hawzu.


Enter the GitLab instance URL and personal access token.

Use Test Connection before continuing. If the test fails, check the instance URL, token value, and GitLab project access.


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

  • Default GitLab Project
  • Default Labels, when available

The project controls where new GitLab issues are created. Labels can help classify issues as they enter GitLab.


Save is available after the connection succeeds and the required GitLab project is selected.

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