> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify-docs-simplify-quickstart-2510244c.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# GitLab

> Sync your docs with a GitLab repo

<Check>
  GitLab integration is available on the [Enterprise plan](https://mintlify.com/pricing).
</Check>

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

## Setup Guide

<Steps>
  <Step title="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
  </Step>

  <Step title="Configure Mintlify">
    Add your Project ID and Access Token in the [Mintlify dashboard](https://dashboard.mintlify.com/mintlify/mintlify/settings/deployment/git-settings).
  </Step>

  <Step title="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
  </Step>
</Steps>

<Note>
  Need help? Contact us [here](https://mintlify.com/enterprise).
</Note>