Skip to content

GitLab credentials#

You can use these credentials to authenticate the following nodes:

Supported authentication methods#

  • API access token
  • OAuth2 (Recommended)

Refer to GitLab's API documentation for more information about the service.

Using API access token#

To configure this credential, you'll need a GitLab account and:

  • The URL of your GitLab Server
  • An Access Token

To set up the credential:

  1. In GitLab, select your avatar, then select Edit profile.
  2. In the left sidebar, select Access tokens.
  3. Select Add new token.
  4. Enter a Name for the token, like n8n integration.
  5. Enter an expiry date for the token. If you don't enter an expiry date, GitLab automatically sets it to 365 days later than the current date.
    • The token expires on that expiry date at midnight UTC.
  6. Select the desired Scopes. For the GitLab node, use the api scope to easily grant access for all the node's functionality. Or refer to Personal access token scopes to select scopes for the functions you want to use.
  7. Select Create personal access token.
  8. Copy the access token this creates and enter it in your n8n credential as the Access Token.
  9. Enter the URL of your GitLab Server in your n8n credential.

Refer to GitLab's Create a personal access token documentation for more information.

Using OAuth2#

Note for n8n Cloud users

Cloud users don't need to provide connection details. Select Connect my account to connect through your browser.

If you're self-hosting n8n, you'll need a GitLab account. Then create a new GitLab application:

  1. In GitLab, select your avatar, then select Edit profile.
  2. In the left sidebar, select Applications.
  3. Select Add new application.
  4. Enter a Name for your application, like n8n integration.
  5. In n8n, copy the OAuth Redirect URL. Enter it as the GitLab Redirect URI.
  6. Select the desired Scopes. For the GitLab node, use the api scope to easily grant access for all the node's functionality. Or refer to Personal access token scopes to select scopes for the functions you want to use.
  7. Select Save application.
  8. Copy the Application ID and enter it as the Client ID in your n8n credential.
  9. Copy the Secret and enter it as the Client Secret in your n8n credential.

Refer to GitLab's Configure GitLab as an OAuth 2.0 authentication identity provider documentation for more information. Refer to the GitLab OAuth 2.0 identity provider API documentation for more information on OAuth2 and GitLab.