> ## 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 OAuth 2.0 (Self-Managed) – StackOne Hub > Link a GitLab account in the StackOne Hub using OAuth 2.0 (Self-Managed). End-user guide to authorize the integration and start using GitLab actions. The GitLab instance must use HTTPS. If it is behind a firewall, allow inbound HTTPS from StackOne's IP addresses.
Select Actions to adjust the guide
Some actions may require additional configuration in the provider to be accessible. Choose the actions you need and the guide will be updated.
Action
Scope(s)
Loading actions...
Dynamic Guide URL
Scopes Selected

          

            
Separator

Register an OAuth application on your instance

Create the application on the same GitLab instance you are connecting.

Sign in to your GitLab instance.

  • For an instance-wide application, go to Admin > Applications (administrators only)
  • For a personal application, go to Edit profile > Applications
  • Click Add new application
Enables actions: Add Group Member, Add Project Deploy Key, Add Project Member, Approve Merge Request, Archive Project, Cancel Auto-Merge, Cancel Pipeline, Cherry-Pick Commit, Compare Branches, Create Branch, Create Commit, Create Environment, Create File, Create Group, Create Issue, Create Issue Note, Create Merge Request, Create Merge Request Note, Create Pipeline, Create Project, Create Project CI/CD Variable, Create Project Label, Create Project Milestone, Create Release, Create Snippet, Create Tag, Create User, Delete Branch, Delete File, Delete Group, Delete Issue, Delete Pipeline, Delete Project, Delete Project CI/CD Variable, Delete Project Deploy Key, Delete Project Label, Delete Project Milestone, Delete Release, Delete Snippet, Delete Tag, Delete User, Enable Project Deploy Key, Fork Project, Get Branch, Get Commit, Get Commit Diff, Get Current User, Get Current User Status, Get Environment, Get File, Get Group, Get Group Merge Request Approval Settings, Get Instance Metadata, Get Issue, Get Job, Get Job Log, Get Merge Request, Get Merge Request Approval State, Get Merge Request Approvals, Get Merge Request Participants, Get Namespace, Get Pipeline, Get Pipeline Variables, Get Project, Get Project Approval Configuration, Get Project CI/CD Variable, Get Project Label, Get Project Milestone, Get Protected Branch, Get Release, Get Repository Contributors, Get Snippet, Get Unified Credentials, Get Unified Group, Get Unified Organization, Get Unified Role, Get Unified User, Get User, Get User Status, List All Group Members, List All Project Members, List Billable Group Members, List Billable Member Memberships, List Branches, List Commits, List Enterprise Users, List Environments, List Group Branch Rules, List Group Descendant Members, List Group Members, List Group Merge Requests, List Group Merge Requests With Approvals, List Group Project Members, List Group Projects, List Group Subgroups, List Groups, List Issue Notes, List Issue Participants, List Merge Request Commits, List Merge Request Diffs, List Merge Request Notes, List Merge Requests For Commit, List Namespaces, List Pending Group Members, List Pipeline Jobs, List Pipelines, List Project Approval Rules, List Project CI/CD Variables, List Project Deploy Keys, List Project Issues, List Project Labels, List Project Members, List Project Merge Requests, List Project Milestones, List Projects, List Protected Branches, List Related Merge Requests, List Releases, List Repository Tree, List Snippets, List Tags, List Unified Groups, List Unified Organizations, List Unified Resource Types, List Unified Resource Users, List Unified Roles, List Unified Users, List Users, Merge Merge Request, Move Issue, Protect Branch, Rebase Merge Request, Remove Group Member, Remove Project Member, Retry Job, Retry Pipeline, Revert Commit, Search Globally, Search In Group, Search In Project, Stop Environment, Unarchive Project, Unprotect Branch, Update Environment, Update File, Update Group, Update Issue, Update Merge Request, Update Project, Update Project CI/CD Variable, Update Project Label, Update Project Member, Update Project Milestone, Update Release, Update Snippet, Update User

Fill in the application details.

  • Name: StackOne
  • Redirect URI: `https://api.stackone.com/connect/oauth2/gitlab/callback`
  • Confidential: leave checked

Click Save application, then copy the Application ID and Secret. The secret is shown only once.

If an administrator connects and Admin Mode is turned on, also select admin\_mode on the application and in the scopes field. Without it GitLab treats the administrator as a regular user, so the instance user roster and two-factor status stay hidden.

Find your instance URL

Use the address you open GitLab at, such as `https://gitlab.example.com`, without a trailing slash or `/api/v4`.

Linking the Account from the Hub

Use one of the three Linking Account Methods to access the Hub. Fill out the following fields using details from your provider:
  • GitLab Instance URL
  • Application ID
  • Application Secret
  • OAuth Scopes (Optional)
  • Click Connect
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider's authorization flow.
  • Once authorization is successful, you will see a confirmation popup

If the account linking is successful, you will see the newly linked account in your Accounts page.

## Next Steps

Configure receiving Events for GitLab into StackOne.

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