Providers
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. Learn more about functional accounts.
GitLab SaaS
GitLab SaaS is the Cloud hosted version of GitLab.
Steps
In the App settings, go to Provider.
Click the Add new Git provider button.
Select GitLab SaaS as your provider option.
Copy the access token from your GitLab account.
Paste the access token in the dedicated field of the GitLab integration.
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
In the App settings, go to Provider.
Click the Add new Git provider button.
Select GitLab Self-Managed as your provider option.
Enter the public URL to connect to your GitLab instance.
Enter the access token from your GitLab account.
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
In the App settings, go to Provider.
Click on the three dots and select Renew access token for the provider that needs its token renewed.
Enter the new access token for the GitLab instance.
Click the Test new access token button.
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
In the App settings, go to Provider.
Click on the three dots and select Remove provider for the provider that you want to remove.
Read the alert carefully, and confirm the removal of the provider.
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 Group Access tokens and Personal access tokens. Both types can be used to connect your monday.com account to GitLab.
Last updated