Skip to main content

GitLab

Set up ClarityLoop’s GitLab integration to bring merge requests and review comments directly into your workspace.

Before you start​

  • Be a workspace owner in ClarityLoop.
  • Have a GitLab group access token or bot personal access token with the api scope (read-only is fine). Add the bot to the projects you want to sync.

Connect GitLab to ClarityLoop​

  1. In ClarityLoop, go to Integrations → GitLab and click Connect.
  2. Enter the GitLab base URL (default https://gitlab.com) and paste your group/bot access token.
  3. Click Save access token. ClarityLoop will:
    • Store the token securely.
    • Show you a webhook URL and secret token you’ll need in GitLab. You can reopen the dialog anytime to copy them again via View instructions.

Configure GitLab webhooks​

  1. In GitLab, open each project or group you want to sync and go to Settings → Webhooks.
  2. Paste the Webhook URL provided by ClarityLoop.
  3. Paste the Secret token exactly as shown.
  4. Select Merge request events and Note events.
  5. Click Add webhook (or Save). Repeat for other projects/groups.

That’s it—new merge requests and review comments will start showing up inside ClarityLoop automatically.

Keeping things up to date​

  • Rotate tokens: If you issue a new GitLab token, simply reopen Connect GitLab in ClarityLoop, paste the replacement token, and save.
  • View webhook info: Use View instructions in the GitLab integration row to copy the webhook URL or secret at any time.
  • Disconnect: Click Remove to delete the stored token and stop receiving GitLab events.

Need help? Contact support and we’ll walk you through the setup on a call.