# Connect GitLab to iftrue using a Personal Access Token

### Before You Start

Make sure the GitLab user you are using:

* Has access to the repositories you want to integrate
* Has sufficient permissions (at least read access to projects)

### Step 1 - Go to Personal Access Tokens

1. Navigate to 

   ```
   https://[your-gitlab-domain]/-/user_settings/personal_access_tokens
   ```
2. Enter a name (e.g., iftrue integration)
3. Set an expiration date (recommended: 1 year)
4. Select the following scopes:

   ✅ api

   ✅ read\_user

   ✅ read\_repository
5. Click Create personal access token

### Step 2 - Connect to iftrue

1. Open the GitLab integration page: 

   ```
   https://app.iftrue.co/onboarding/git?provider=gitlab&settings=true
   ```
2. Paste your token and base url for the gitlab into the required field
3. Complete the setup

<figure><img src="https://2197265994-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT9wQ8QTbpuYT55h9etnB%2Fuploads%2FXPwRvHE7kErEYTqoITsO%2FScreenshot%202026-03-17%20at%2014.00.19.png?alt=media&#x26;token=8551078f-c28a-45d7-b4cb-c45a68f30e4e" alt=""><figcaption></figcaption></figure>