Skip to content

GitLab SaaS

SaaS Management integrates directly with GitLab SaaS to retrieve all user activity within the application. The integration gives you the usage data you need to make informed decisions on inactive licenses and any renewal or purchasing options.


SaaS Management does not access or request access to your code or commits.

Integrating with GitLab SaaS

SaaS Management pulls in a list of user and event data from your GitLab top-level group, including data from all subgroups within that top-level group. To complete the integration, you must copy and paste your GitLab top-level group ID into SaaS Management.

You must be assigned the Owner role for the top-level group to connect SaaS Management with your GitLab SaaS instance.


Before you integrate the applications, make sure you have signed out of your individual account within your organization and are signed in to the appropriate service account with the required permissions.

Copying your Top-level Group ID from GitLab SaaS

  1. Log in to your GitLab account with the appropriate permission.

  2. Select Menu from the navigation menu. From the dropdown menu, select Groups > Your groups to view your group memberships.

  3. On the Groups page, select the top-level group, the parent group of all subgroups.


    If there are multiple top-level groups, you must create multiple integrations. You can only map one top-level group to an integration instance.

    The Group ID appears under the name of the group.

  4. Select Copy group ID to copy your group ID.

    You’ll enter the Group ID in SaaS Management to connect GitLab SaaS to the application.

Connecting your GitLab SaaS account

  1. Select the Integrations tab from the SaaS Management navigation menu.

  2. Select the GitLab SaaS tile.

  3. Select Add Integration.

  4. Enter the Group ID from GitLab SaaS in the Your GitLab Top-level Group ID field and select Submit.

  5. On the GitLab login page, enter your credentials and select Sign in.

  6. Select Authorize to accept the requested permissions and complete the integration.

Your GitLab SaaS data will begin syncing immediately and should complete within 24 hours.

Requested Scopes

SaaS Management requests the following scopes:

Scope Description
read_api Grants read access to the API, including all groups and projects, the container registry, and the package registry. This access allows SaaS Management to pull user data as well as every change to a pull request or issue.

User Metadata

SaaS Management pulls the following user metadata from GitLab SaaS. You can filter your usage data by these fields:

Field Description
State The user's current state.
Membership Type   The user's membership type.
Removable Indicates whether the billable member can be removed from a group and its subgroups and projects.