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

Creating an OAuth Application

To connect GitLab with StackOne, you'll need to create an OAuth application in your GitLab account.

Click on your profile avatar in the top-right corner
Select Edit profile from the dropdown menu
In the left sidebar, expand the Access section
Click Applications from the expanded menu

Click the Add new application button to create a new OAuth application.

Name: Enter a descriptive name (e.g., StackOne Integration)
Redirect URI: Enter `https://api.stackone.com/connect/oauth2/gitlab/callback`
Confidential: Leave this checkbox checked (recommended for server-side applications)

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

Select the appropriate scopes based on your integration requirements. Use api for full API access, or select granular scopes for specific permissions. For read-only access reviews and compliance checks, read\_api and read\_user are enough. If you select only those two, enter `read_api read_user` in the OAuth Scopes field when you connect, because the default requests all five scopes and GitLab refuses scopes the application does not have.

Click Save application to create your OAuth application.

After saving, your Application ID and Secret will be displayed.

Copy the Application ID and store it securely for use later
Copy the Secret immediately as it will only be shown once
If you lose the Secret, you'll need to regenerate it from the application settings

## Creating the StackOne Connector Profile To create the Connector Profile in StackOne for GitLab: Login to StackOne and navigate to [Connector Profiles](https://app.stackone.com/connector_profiles)

Click + Connector Profile
Search for and select GitLab
Select Type as OAuth 2.0
Fill out the fields using details retrieved from your provider:
- Application ID
- Application Secret
- OAuth Scopes (Optional)
(Optional) Select Actions to be enabled for this Connector Profile
Click Create profile

Congratulations! The new Connector Profile will now show up in your project ready to be used. You can now continue to Link Accounts for GitLab. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.