GitLab for monday.com
HomepageContact Support
  • Introduction
    • Intro to GitLab for monday.com
    • Overview
    • Release notes
  • Getting started
    • Initial setup
  • App settings
    • Providers
    • Audit log
    • Connections
  • Automations
    • Integration recipes
    • Legacy
      • Monday.com -> GitLab
      • GitLab -> Monday.com
  • Item view [coming soon]
    • Overview
    • Board connections
    • Branches
    • Merge requests
  • Using the app
    • Add GitLab to a board
    • Functional Accounts
  • External links
    • Request a feature
    • Monday.com marketplace
    • Security/Privacy policies
Powered by GitBook
On this page
  • On this page
  • Adding a provider
  • GitLab SaaS
  • GitLab Self-Managed
  • Renew an access token
  • Remove a provider
  • FAQ
  • What scope must my GitLab access token have?
  • What type of access token is required?

Was this helpful?

  1. App settings

Providers

PreviousApp settingsNextAudit log

Last updated 7 months ago

Was this helpful?

On the Providers page in the app settings you'll find all necessary information of a connected provider.

On this page

Adding a provider

Providers are the beating heart of our app. A providers connects your GitLab instance with your monday.com account. You can choose to connect to a GitLab SaaS account or a Self-Managed environment.

👤 Functional account

We highly recommend using a functional account to connect with GitLab. The use of functional accounts prevents GitLab and its integrations to stop working when, for example, an employee leaves the company. .

GitLab SaaS

GitLab SaaS is the Cloud hosted version of GitLab.

Steps

  1. In the App settings, go to Provider.

  2. Click the Add new Git provider button.

  3. Select GitLab SaaS as your provider option.

  4. Copy the access token from your GitLab account.

  5. Paste the access token in the dedicated field of the GitLab integration.

  6. Click the Connect button to test and save the connection.

GitLab Self-Managed

The self hosted version of GitLab can also be connected to your monday.com account. You'll need to set-up a public URL for us to connect to. We recommend using a subdomain structure like gitlab.example.com.

Steps

  1. In the App settings, go to Provider.

  2. Click the Add new Git provider button.

  3. Select GitLab Self-Managed as your provider option.

  4. Enter the public URL to connect to your GitLab instance.

  5. Enter the access token from your GitLab account.

  6. Click the Connect button to test and save the connection.

Renew an access token

Whenever an access token is about to expire you can replace the token with a new one. This makes sure the app can still access your GitLab account and receives triggers for automations and can associate branches and merge requests.

Steps

  1. In the App settings, go to Provider.

  2. Click on the three dots and select Renew access token for the provider that needs its token renewed.

  3. Enter the new access token for the GitLab instance.

  4. Click the Test new access token button.

  5. Once everything is in order, you can Activate the new access token.

Remove a provider

If you are, for example, moving from a SaaS environment to a Self-Managed instance you might want to connect to a different provider.

Steps

  1. In the App settings, go to Provider.

  2. Click on the three dots and select Remove provider for the provider that you want to remove.

  3. Read the alert carefully, and confirm the removal of the provider.

🔔 Note

When you remove a provider you will also loose the integrations for that provider. You'll need to set these up once again when a new provider is added.

FAQ

What scope must my GitLab access token have?

The GitLab integration requires only the api scope to work. You can manage the scope of an access token the moment your create it. This can not be altered after creation.

What type of access token is required?

GitLab has and . Both types can be used to connect your monday.com account to GitLab.

Group Access tokens
Personal access tokens
Learn more about functional accounts
Adding a provider
Renew an access token
Remove a provider
FAQ