Skip to main content
Ensure you have access to create OAuth applications in your GitLab account. For organization-wide access, you may need Owner or Administrator privileges.

​
Creating an OAuth Application

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

1

Sign in and navigate to Applications

Sign in to 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
2

Create a new application

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

  • Name: Enter a descriptive name (e.g., StackOne Integration)
  • Redirect URI: Enter the Callback URL from your Connector Profile
  • Confidential: Leave this checkbox checked (recommended for server-side applications)
3

Select OAuth scopes

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.

4

Save the application

Click Save application to create your OAuth application.

5

Copy Application credentials

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:
1

Open the connector

Log in to StackOne, open Connectors, and select GitLab.
2

Choose actions and events

  • Click Add Profile.
  • If the connector offers more than one authentication method, set the Auth Method filter to OAuth 2.0.
  • Select the actions, and any events, to enable for this Connector Profile.
  • Click Continue.
3

Set up authentication

  • Select Authentication Type as OAuth 2.0.
  • Fill out the fields using details retrieved from your provider:
    • Application ID
    • Application Secret
    • OAuth Scopes (Optional)
  • Click Create Profile.
Congratulations! The new Connector Profile now shows up on the connector page. If you created it as a project member rather than an admin, it starts disabled until a project admin enables it. You can now continue to Link Accounts for GitLab.