GitLab integration

Connect to GitLab via OAuth; link commits, MRs and pipelines to tasks.

When you connect a board to a GitLab repository, commit, merge request and pipeline events sync live via webhook and appear on the related tasks. Just include the task key (e.g. CJ-244) in the commit message or the branch name.

GitLab is currently the only supported provider (gitlab.com and self-managed GitLab instances). GitHub and Bitbucket are on the roadmap.

Setup

  1. 1Connect to GitLab from board settings → Integrations (secure OAuth authorization).
  2. 2Select a repository; the projects your GitLab account can reach are listed.
  3. 3A webhook secret is generated automatically (visible only to workspace admins).
  4. 4The Commits, Merge Requests and pipeline panels on task detail start populating.

What you see inside a task

  • Branch: branches matching the task key, with a one-click checkout command
  • Merge request: state (open/merged/closed), approval count, MR number
  • Pipeline: live status of the build / test / deploy stages
  • Commit list: short SHA, message and author

Event → status automation

You can map GitLab events onto workflow statuses: MR opened → In Progress, commit pushed → In Progress, MR merged → Review, issue closed → Done. Automation is forward-only; it never moves a task backwards.

Issue import

You can import GitLab issues from the connected repository into the board in one click: opened, closed or all. Title, description, labels and assignee are mapped; imported issues then stay in sync over the webhook.

app.themyway.app/boards/platform/settings/integrations
The GitLab panel and event → status mappingThe GitLab panel and event → status mapping
The GitLab panel and event → status mapping

Tokens are stored encrypted with AES-256-GCM on the server; webhook signatures are verified with HMAC. Keys stay on your server and never go to a third party.