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”
  1. Test the webhook using “Push events” - Should return HTTP 200
Need help? Contact us here.