> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect GitLab with Personal Access Token – StackOne Hub

> Link a GitLab account in the StackOne Hub using Personal Access Token. End-user guide to authorize the integration and start using GitLab actions.

> [!WARNING]
>
> To list a group's members, its pending invitations and the people with access only to its subgroups or projects, create the token as an Owner of that top-level group. Other roles see direct members only.

## Create an access token

Use a personal access token, or a group access token for a bot user.

**1. Open Access tokens**

Sign in to GitLab.

<ul>
  <li>Personal access token: **Edit profile** > **Access tokens** > **Add new token**</li>
  <li>Group access token: open the group, then **Settings** > **Access tokens** > **Add new token**</li>
</ul>

**2. Choose scopes**

Select **read\_api** for read-only access, or **api** to also use write actions. On GitLab Self-Managed with Admin Mode turned on, an administrator also selects **admin\_mode** to read the instance user roster and two-factor status. Set an expiry date that fits your rotation policy.

**3. Copy the token**

Click **Create token** and copy it. GitLab shows it only once.

## Find your instance URL

Leave the instance URL empty for GitLab.com. For GitLab Self-Managed or Dedicated, use the address you open GitLab at, such as `https://gitlab.example.com`, without a trailing slash or `/api/v4`. If the instance is behind a firewall, allow inbound HTTPS from [StackOne's IP addresses](https://docs.stackone.com/connect/troubleshooting.md#connection-issues-behind-a-firewall).

## Link the Account

**1. Connect**

<ul>
  <li>Click **Connect**.</li>
  <li>If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider's authorization flow.</li>
  <li>Once authorization is successful, you will see a confirmation popup.</li>
</ul>

**2. Use Actions**

Connect an AI platform to the linked account's actions. See [AI Platforms](https://docs.stackone.com/connect/ai-platforms/overview.md).

Other ways to call actions are listed in [Protocols & SDKs](https://docs.stackone.com/connect/protocols-and-sdks.md).

## Next Steps

> [card] [Webhooks setup](https://docs.stackone.com/connectors/gitlab/guides/webhook-setup.md)
>
> Configure receiving Events for GitLab into StackOne.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.