Skip to main content

Integrations

GitLab

Personal Plus & Studio

HacknPlan integrates with GitLab to attach commits to work items using references in commit messages (default prefix hnp-).

Two setup modes are available.

Automatic integration (GitLab.com)

Use this mode when repositories are hosted on GitLab.com.

Steps:

  1. Open Administration -> Integrations and select New -> GitLab -> Auto.
  2. Provide a GitLab personal access token.
  3. Select the repository and save.

Token requirements: API access.

Recommended token settings:

  • recognizable name (for example, HacknPlan)
  • no forced expiration unless required by your policy

Manual integration (self-hosted or custom setup)

Use this mode for self-managed GitLab instances.

Steps:

  1. In HacknPlan, select New -> GitLab -> Manual to generate webhook credentials.
  2. In GitLab project settings, open Settings -> Webhooks.
  3. Add a webhook with the provided URL and secret token.
  4. Save webhook configuration.

Test the integration

Push a commit referencing an existing item, for example:

This is a test for task hnp-2

If detected successfully, the commit appears in the item's Source Code tab with a link to GitLab.