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 https://api.stackone.com/connect/oauth2/gitlab/callback
  • 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 Issue, Get Job, Get Job Log, Get Merge Request, Get Merge Request Participants, Get Namespace, Get Pipeline, Get Pipeline Variables, Get Project, Get Project CI/CD Variable, Get Project Label, Get Project Milestone, 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 Branches, List Commits, List Environments, List Group 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 Namespaces, List Pipeline Jobs, List Pipelines, 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 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.

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

Navigate to Connector Profiles

Login to StackOne and navigate to Connector Profiles
2

Create New Connector Profile

  • 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.