--- sourceDocument: Yokohama Data and Automation sourceDocumentLink: https://www.servicenow.com/docs/r/yokohama/integrate-applications Release : - yokohama ft:locale : - en-US ft:publication_title : - Yokohama Data and Automation ft:clusterId : - crint bundleId : - crint workflow : - Creator --- # GitLab Spoke # GitLab Spoke {#ariaid-title1} * Release version: Yokohama * * Updated May 15, 2025 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 8 minutes to read Manage the DevOps lifecycle in GitLab from your ServiceNow instance. Create flows in ServiceNow to manage branches, groups, issues, merge requests, projects, and source code in GitLab. ## Request apps on the Store {#gitlab-spoke__section_xcf_3df_mjb} Visit the [ServiceNow Store](https://store.servicenow.com/sn_appstore_store.do#!/store/home) website to view all the available apps and for information about submitting requests to the store. For cumulative release notes information for all released apps, see the [ServiceNow Store version history release notes](https://www.servicenow.com/docs/r/store-release-notes/sn-store-release-notes.html).{#gitlab-spoke__inline-send-to-store} ## Integration Hub subscription {#gitlab-spoke__section_rsf_yvb_l3b} This spoke requires an Integration Hub subscription. For more information, see [Legal schedules - IntegrationHub overview](https://www.servicenow.com/content/dam/servicenow-assets/public/en-us/doc-type/legal/snc-addendum-integrationhub.pdf). ## Spoke version {#gitlab-spoke__section_nzr_shv_bsb} GitLab spoke v2.5.0 is the latest version.{#gitlab-spoke__gitlab-ver} ## Compatible versions {#gitlab-spoke__section_wqn_prj_whb} This spoke was built for GitLab API version v4, but may be compatible with later versions. ## Spoke requirements {#gitlab-spoke__section_b1k_rrj_whb} * GitLab account * An application in GitLab configured to integrate with ServiceNow * Application ID and Secret of the GitLab application {#gitlab-spoke__ul_jw5_ls3_hkb}See the documentation for instructions on creating and configuring applications. ## Spoke actions {#gitlab-spoke__section_x1l_253_hkb} The GitLab spoke provides actions to automate GitLab tasks when events occur in ServiceNow. Available actions include: {#gitlab-spoke__table_ctl_353_hkb__entry__3} | Category | Action | Description | |-|-|-| | Branch Management | Compare Branches Tags or Commits | Compares branches, tags, or commits. | | Branch Management | Create Branch | Creates a branch in the required project. | | Branch Management | Delete Branch | Deletes the required branch from a project. | | Branch Management | Delete Merged Branches | Deletes the required merged branch from a project. | | Branch Management | Look up Branch | Retrieves the details of the required branch. | | Branch Management | Look up Branches Stream | Retrieves a list of branches and the branch details in a project. | | Branch Management | Protect Branch | Protects a branch in a project with access levels. | | Branch Management | Unprotect Branch | Unprotects a branch in a project with access levels. | | Group Management | Add User To A Group | Adds user to a GitLab group. | | Group Management | Remove User From A Group | Removes user from a GitLab group. | | Issue Management | Create Issue | Creates an issue in the required project. | | Issue Management | Create Issue Note | Creates an issue note for the required issue. | | Issue Management | Delete Issue Note | Deletes an issue note for the required issue. | | Issue Management | Look up Issue Notes Stream | Retrieves all issue notes in an issue. | | Issue Management | Look up Issues Stream | Retrieves a list of issues and issue details. | | Issue Management | Update Issue | Updates details of the required issue. | | Issue Management | Update Issue Note | Updates an issue note in a project. | | Merge Request Management | Accept Merge Request | Approves a merge request in GitLab. | | Merge Request Management | Create Merge Request | Creates a merge request in GitLab. | | Merge Request Management | Create Merge Request Note | Creates a note for the required merge request. | | Merge Request Management | Delete Merge Request Note | Deletes a note for the required merge request. | | Merge Request Management | Look up all Merge Requests Stream | Retrieves the list of merge requests in a project. | | Merge Request Management | Look up Merge Request Notes | Retrieves the list of merge request notes in a project. | | Merge Request Management | Update Merge Request | Updates details of the required merge request. | | Merge Request Management | Update Merge Request Note | Updates details of the required merge request note. | | Package Management | Delete Package File | Deletes a package file from the project package registry. | | Package Management | Delete Project Package | Deletes a package from the project package registry. | | Package Management | Delete Registry Repository | Removes a registry repository from a project. | | Package Management | Delete Registry Repository Tags | Removes registry repository tags in a batch from a project. | | Package Management | Look up Details of a Registry | Retrieves details of a registry repository for a specified project. | | Package Management | Look up Package Files Stream | Retrieves list of package files of a single package. | | Package Management | Look up Packages within Group Stream | Retrieves a list of project packages and package details at the group level. | | Package Management | Look up Packages within Project Stream | Retrieves a list of project packages and package details. | | Package Management | Look up Project Package | Retrieves the details of the specified package for a specified project. | | Package Management | Look up Registry Repositories | Retrieves a list of registry repositories for a specified project. | | Pipeline Management | Look up Project Pipeline by ID | Retrieves the details of a specified pipeline for a specified project. | | Pipeline Management | Look up Project Pipeline Jobs Stream | Retrieves the list of jobs in a project pipeline. | | Pipeline Management | Look up Project Pipeline Test Report | Retrieves the test report of the specified pipeline for the specified project. | | Pipeline Management | Look up Project Pipelines Stream | Retrieves the list of pipelines in a project. | | Project Hook Management | Create Project Hook | Creates a hook to a project. | | Project Hook Management | Delete Project Hook | Removes a hook from a project. | | Project Hook Management | Look up Project Hook | Retrieves details of a specified hook in a project. | | Project Hook Management | Look up Project Hooks | Retrieves details of all the hooks in a project. | | Project Hook Management | Update Project Hook | Updates details of a hook for a specified project. | | Project Management | Add User To A Project | Adds user to a project in GitLab. | | Project Management | Archive Project | Archives a project in GitLab. | | Project Management | Create Milestone | Creates milestone in a GitLab project. | | Project Management | Create Project | Creates a project in GitLab. | | Project Management | Delete Milestone | Deletes milestone in a GitLab project. | | Project Management | Delete Project | Deletes a project in GitLab. | | Project Management | Look up Milestones Stream | Retrieves the details of the milestones GitLab. | | Project Management | Look up Project | Retrieves details of the specified project. | | Project Management | Look up Project Jobs Stream | Retrieves the project jobs details. | | Project Management | Look up Projects Stream | Retrieves the details of the projects. | | Project Management | Remove User from a Project | Removes user from a project in GitLab. | | Project Management | Share Project With Group | Shares a project with a group in GitLab. | | Project Management | Unarchive Project | Unarchives a project in GitLab. | | Project Management | Unshare Project With Group | Unshares a project with a group in GitLab. | | Project Management | Update Milestone | Updates details of a milestone in a project. | | Project Management | Update Project | Updates details of a project. | | Source Code Management | Get Commit | Retrieves a details of a commit in GitLab. | | Source Code Management | Add New File To Repository | Adds a file to a repository in GitLab. | | Token Management | Look up Personal Access Tokens | Retrieves a list of personal access tokens. | | Token Management | Revoke Personal Access Token | Revokes a personal access token. | [ ] {#gitlab-spoke__table_ctl_353_hkb} ## Available AI agents {#gitlab-spoke__section_amq_vlg_xgc} Install Now Assist for Integration Hub and start using the available AI agents. For more information, see [Now Assist for Integration Hub](https://www.servicenow.com/docs/nHAEAt7p2s5Ixjp7nysTHA "Use the ServiceNow Now Assist AI agents to mimic human-like intelligence by using Large Language Models (LLMs) to perform tasks that range from simple automated responses to complex problem-solving. Utilize the conversational ability of Integration Hub spoke actions."). This spoke provides standalone AI agents that mimic human-like intelligence to perform tasks in your ServiceNow instance. * In the ServiceNow agentic system, you can create an agentic workflow that comprises of a set of large language model (LLM) instructions along with one or more standalone AI agents to execute an objective. See [Create an agentic workflow](https://www.servicenow.com/docs/access?context=configure-use-case-ai-agents&version=yokohama&pubname=yokohama-intelligent-experiences&ft:locale=en-US) for information about adding AI agents to create agentic workflows as per your requirement and provide the required trigger. You can also search for other available AI agents and add them to your agentic workflow. See [Find AI agents](https://www.servicenow.com/docs/access?context=find-ai-agents&version=yokohama&pubname=yokohama-intelligent-experiences&ft:locale=en-US) for more information. * You can create a clone of the required spoke AI agent and customize it as per your requirement. See [Duplicate an AI agent](https://www.servicenow.com/docs/access?context=clone-ai-agent&version=yokohama&pubname=yokohama-intelligent-experiences&ft:locale=en-US) for more information about creating a clone. * See [Now Assist AI agents](https://www.servicenow.com/docs/access?context=na-ai-agents&version=yokohama&pubname=yokohama-intelligent-experiences&ft:locale=en-US) for information about AI agents. {#gitlab-spoke__ul_tjz_vtr_m2c} Available AI agents include: {#gitlab-spoke__table_asv_bmg_xgc__entry__2} | AI Agent | Description | |-|-| | GitLab pipeline management AI agent | Manages pipeline tasks (that is, looks up project pipelines by ID, retrieves pipeline test reports, streams project pipeline jobs and streams project pipeline data) in GitLab. | | GitLab branch management AI agent | Manages branch management (that is, compare branches, tags, or commits, creates and deletes branches, manages branch protection, and looks up branch details or streams) in GitLab. | | GitLab merge request management AI agent | Manages merge requests (creates, updates, accepts, and deletes merge request notes, and retrieves information about merge request notes) in GitLab. | | GitLab package management AI agent | Manages package management (that is, deletes project packages, manages registry repositories, and performs detailed lookups for packages and files) in GitLab. | | GitLab token management AI agent | Manages token management (that is, looks up and revokes personal access tokens) in GitLab. | | GitLab issue management AI agent | Manages issue management tasks (that is, creates, updates, and manages issues and the related notes) in GitLab. | | GitLab project management AI agent | Manages project management tasks (that is, creates, updates, and deletes projects and milestones, manages user and group access, and retrieves project and milestone streams) in GitLab. | | GitLab source code management AI agent | Manages source code tasks (that is, looks up commit difference, adds new file to repository, and looks up commit by project ID) in GitLab. | | GitLab group management AI agent | Manages user-group tasks (that is, adds and removes users from groups) in GitLab. | [ ] {#gitlab-spoke__table_asv_bmg_xgc} Looking for an AI agent? * There might be AI agents installed with the Now Assist application that are not used in agentic workflows. To learn how to see all agents that are available on your instance, see [Find AI agents](https://www.servicenow.com/docs/access?context=find-ai-agents&version=yokohama&pubname=yokohama-intelligent-experiences&ft:locale=en-US). * To find agents that might not be installed on your instance, visit the [AI Agent Marketplace](https://store.servicenow.com/store/ai-marketplace) on the ServiceNow Store. {#gitlab-spoke__ul_fjk_5cd_4gc} Note: Ensure that the user running an AI agent has the required roles and permissions to access data or perform operations on data in the table that is associated with the AI agent. ## Spoke flows {#gitlab-spoke__section_bvx_gq4_g5b} The GitLab spoke provides sample flows to demonstrate automating the GitLab tasks. To customize a sample flow, copy it to a new application scope.{#gitlab-spoke__table_dkv_hq4_g5b__entry__2} | Flow | Description | |-|-| | Archive projects older than 6 months | Archives the projects which are inactive for the last six months. | [ ] {#gitlab-spoke__table_dkv_hq4_g5b} ## Spoke subflows {#gitlab-spoke__section_b3y_tz3_g5b} The GitLab spoke provides sample flows to demonstrate automating the GitLab tasks. To customize a sample subflow, copy it to a new application scope. Available sample subflows include:{#gitlab-spoke__table_ism_vz3_g5b__entry__2} | Subflows | Description | |-|-| | Process GitLab Deployment Webhook Events​ | Processes deployment webhooks in GitLab. | | Process GitLab Job Webhook Events​ | Processes job webhook events in GitLab. | | Process GitLab Merge Request Webhook Events | Processes merge request webhook events in GitLab. | | Process GitLab Pipeline Webhook Events​ | Processes pipeline webhook events in GitLab. | | Process GitLab Push Webhook Events​ | Processes push webhook events in GitLab. | [ ] {#gitlab-spoke__table_ism_vz3_g5b} ## Spoke webhooks {#gitlab-spoke__section_ijl_tbj_g5b} Bi-directional webhooks can be setup to be notified about the required events. Routing policy defines conditions that must be met to notify the ServiceNow app. These conditions are based on the events in GitLab for which you wish to be notified about. When the conditions are met, routing policy triggers the associated subflow, which in turn automates the GitLab tasks. The bi-directional webhooks requires separate setup and can be used independently without using the spoke actions. By default, the GitLab Webhooks application is available in the GitLab spoke and has the following modules:{#gitlab-spoke__table_ekz_wbj_g5b__entry__2} | Webhook | Description | |-|-| | GitLab Webhook Registries | Displays the list of available webhook registries. | | GitLab Webhook Routing Policies | Displays the list of available webhook routing policies. | [ ] {#gitlab-spoke__table_ekz_wbj_g5b} ## Spoke module {#gitlab-spoke__section_ykc_phg_rmb} The GitLab spoke provides Gitlab Token Management application that includes the Gitlab Token Managements module. You should record here to authenticate requests from your ServiceNow instance. ## Connection and credential alias requirements {#gitlab-spoke__section_plx_qxg_gfb} Integration Hub uses aliases to manage connection and credential information, and OAuth credentials. Using an alias eliminates the need to configure multiple credentials and connection information profiles when using multiple environments. If the connection or credential information changes, you don't need to update any actions that use the connection. For information about setting up the spoke, see [Set up the GitLab spoke](https://www.servicenow.com/docs/KZHu2EllfUbnmOzMoDPJrQ#setup-gitlab-spoke "Integrate your ServiceNow instance and the GitLab by creating a custom OAuth application in the GitLab.").