GitLab integration is available on the Enterprise plan.

Mintlify uses Access tokens for pulling information from GitLab and Webhooks for receiving notifications about repository changes.

Setup Guide

1

Get Project Information

  1. Find your Project ID under Settings > General
  2. Generate an access token:
  • Go to Settings > Access Tokens
  • Create a new token named “Mintlify”
  • For private repos, set role as Maintainer
  • Select api and read_api scopes
  • Create and copy the token
2

Configure Mintlify

Add your project ID and access token in the Mintlify dashboard.

3

Set Up Webhook

  1. Go to Settings > Webhooks
  2. Add new webhook with URL: https://leaves.mintlify.com/gitlab-webhook
  3. Enter the Webhook token from Mintlify dashboard
  4. Enable:
  • Push events (All branches)
  • Merge requests events
  1. Test the webhook using “Push events” - should return HTTP 200

Need help? Contact the Mintlify team here.

Was this page helpful?