GitLab

Sync your docs with a GitLab repo

GitLab integration is available on the Enterprise plan.

Mintlify uses Access tokens for pulling information from GitLab and Webhooks for automatic deployments when changes are made.

Setup Guide

1

Prepare GitLab Project

1. Find your Project ID under Settings > General
2. Generate an Access Token:

• Go to Settings > Access Tokens
• Create a 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:

• URL: https://leaves.mintlify.com/gitlab-webhook
• Name: “Mintlify”
• Token: Use webhook token from Mintlify dashboard
• Events: Select “Push events” and “Merge requests events”

3. Test the webhook using “Push events” - Should return HTTP 200

Need help? Contact us here.