Getting Started

GitLab Integration

Commitloom integrates with GitLab via webhook and a project access token. Setup takes approximately 5 minutes.

Requirements

  • GitLab.com or self-managed GitLab v15.0 or later
  • Maintainer or Owner role on the GitLab project
  • Commitloom Team plan or above (GitLab integration requires Team tier)

Step 1: Create a project access token

  1. Go to your GitLab project → Settings → Access Tokens
  2. Create a new token with the following scopes: api (read merge request diffs and post comments)
  3. Set a role of Developer or above
  4. Copy the generated token — you'll need it in step 3

Token rotation: Set a reminder to rotate the project access token before expiry. Commitloom will stop receiving webhooks if the token expires.

Step 2: Configure the Commitloom webhook

  1. In your Commitloom dashboard, go to Repositories → Connect GitLab
  2. Enter your GitLab project URL (e.g. https://gitlab.com/org/repo)
  3. Paste your project access token
  4. Commitloom will generate a webhook URL and secret for you — copy both

Step 3: Add the webhook to GitLab

  1. Go to your GitLab project → Settings → Webhooks
  2. Paste the webhook URL from step 2
  3. Paste the secret token from step 2
  4. Under Trigger, enable: Merge request events
  5. Enable SSL verification (required)
  6. Click Add webhook

Verify the connection

After creating the webhook, click Test → Merge request events in GitLab webhook settings. You should see a 200 response from Commitloom. Then open a new MR to trigger a full review.

Self-managed GitLab

Self-managed GitLab is supported on v15.0+. The webhook URL and token setup is identical. Ensure your GitLab instance can reach api.commitloom.com over HTTPS (port 443).