Helpin
Dark mode
GitLab integration

GitLab integration

Connect GitLab so Helpin agents can work in your GitLab projects and your tasks show delivery progress. Agents can create branches, commit changes, and open merge requests, and Helpin updates the related task as the merge request moves forward.

GitLab connects with an access token that you create in GitLab. It works with GitLab.com and with self-managed GitLab.

Before you start

  • You need to be an organization Owner or Admin in Helpin.

  • Create a GitLab personal, group, or project access token with the api, read_repository, and write_repository scopes.

  • The token's owner needs Maintainer access on the projects you want to connect. Helpin acts as that user for branches, merge requests, and webhooks.

Connect GitLab

  1. Open Settings and, under Organization, select Git connections.

  2. Select Connect GitLab (or Connect Another GitLab Account if you already have one).

  3. Fill in the Connect GitLab dialog:

Field

What to enter

GitLab URL

https://gitlab.com or your self-managed GitLab URL

Token type

Personal Access Token, Group Access Token, or Project Access Token

Token

The access token you created

Label (optional)

A name that helps you recognize the connection

Commit author name

The author name used for agent commits

Commit author email

The author email used for agent commits

  1. Select Connect. Helpin confirms with GitLab connected as followed by the token's user.

  2. Select Manage workspace repositories to make projects available to a workspace. See Workspace repositories.

GitLab push rules may require the commit author email to be verified for the token's owner. Until you set an email, the card shows Commit author email required before Forge can push.

What Helpin does with GitLab

  • Agent work: coding agents create branches, commit, and open merge requests.

  • Webhooks: when you enable a project, Helpin tries to add a project webhook for push, merge request, pipeline, and release events. This requires a token that can manage webhooks.

  • Delivery progress: for branches and merge requests linked to a task, updates appear in the task's Delivery progress timeline. If your team uses automatic state sync, opening or closing a merge request can move the task.

  • Automations: push, merge request, pipeline, and release events can trigger automation rules.

Manage the connection

On the connection card you can refresh the connection, select the pencil icon to change the Commit identity, and see how many workspaces and repositories use it.

If your token expires or is revoked, Helpin can no longer reach your projects. Create a new token in GitLab and update the connection. Helpin checks the token when you connect; later actions can still fail if the token lacks access to a specific project.

Disconnect GitLab

  1. On Git connections, select the trash icon on the connection.

  2. In Disconnect Git provider, select Disconnect.

This removes repository access from every workspace that used the connection. You can also revoke the token in GitLab.

Was this article helpful?