---
sourceDocument: Australia Workflow Data Fabric
sourceDocumentLink: https://www.servicenow.com/docs/r/integrate-applications

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia Workflow Data Fabric

ft:clusterId :

    - crint

bundleId :

    - crint

workflow :

    - Creator


---

# Set up the GitLab spoke

# Set up the GitLab spoke {#ariaid-title1}

* Release version: Australia
* 
* Updated March 12, 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read

Integrate your ServiceNow instance and the GitLab by creating a custom OAuth application in the GitLab.

## Before you begin

* Request an Integration Hub subscription.
* Activate the GitLab spoke.
* Create an account with GitLab at <https://gitlab.com/users/sign_in>.
* Role required: admin.
{#setup-gitlab-spoke__ul_sh4_dtg_2hb}

## Add GitLab token {#ariaid-title2}

Add GitLab token to authenticate
requests from your ServiceNow instance.

### Before you begin

Role required: admin.

### Procedure

1. Navigate to AllGitLab Token ManagementGitLab Token Managements.
2. Click New.
3. On the form, fill these values.  
   {#add-gitlab-token__table_wzf_hhg_rmb__entry__2}

   | Field | Description |
   |-|-|
   | Secret | Secret created during the GitLab application configuration. |
   | Name | Name to identify the record. |
   | OAuth Entity Profile | Leave the field empty. System auto-assigns the default entity profile after the connection is configured. |
   [Table 1. Gitlab Token Management form]

   {#add-gitlab-token__table_wzf_hhg_rmb}
4. Right-click the form header and click Save.
5. Click Generate Secure Token.  
   Value of the generated secure token is displayed.
6. Copy and record the value of the secure token for later use.
7. Click Update.

## Create OAuth application in GitLab account {#ariaid-title3}

Create a custom OAuth application from your GitLab account to enable OAuth 2.0 authentication with the GitLab spoke.

### Before you begin

* GitLab account
* Role required: GitLab admin.
{#create-app-gitlab__ul_nhk_cnh_gfb}

### About this task

Complete these steps from your GitLab account. See the [GitLab](https://docs.gitlab.com/ee/README.html) documentation for instructions on creating and configuring applications.

### Procedure

1. From your GitLab account, create an application.
2. Enter ServiceNow instance URL in Redirect URI.  
   The format of the redirect URL is: <kbd class="ph userinput">https://&lt;instance-name&gt;.service-now.com/api/sn_gitlab_spoke/gitlab_oauth_redirect/oauth?secureToken=&lt;Secure-Token&gt;</kbd>.

   Replace
   \<Instance-Name\> with the name of your ServiceNow instance and replace
   \<Secure-Token\> with the secure token you had
   generated in the ServiceNow instance.
3. Copy and record the Application Id and Secret for later use.  
   These details are required to register the application as a third-party OAuth provider on your ServiceNow instance.
{#create-app-gitlab__steps_zzx_w4p_ngb}

### Result

The custom OAuth application from your GitLab account is created and can be integrated with the ServiceNow instance.

## Configure a connection for the GitLab spoke {#ariaid-title4}

Add and configure a GitLab connection to authenticate ServiceNow requests in GitLab
spoke.

### Before you begin

Role required: admin

### Procedure

1. Navigate to AllProcess AutomationWorkflow Studio.
2. Click the Integrations tab.
3. Under Connections, the Outbound connections are displayed by default.
4. Locate the GitLab connection alias and click View Details.
5. Click Edit or if you are configuring the spoke for the first time, click Configure.
6. On the Connection form, fill in the fields.  
   {#gitlab-conf-temp__table_tfv_3d5_h5b__entry__2}

   | Field | Description |
   |-|-|
   | Connection Name | Name to uniquely identify the connection. |
   | Connection URL | Enter <kbd class="ph userinput">https://gitlab.com/api</kbd>. Note: If you have installed GitLab on an on-premise server, enter the URL in this format: <kbd class="ph userinput">https://&lt;gitlab-hosted-instance&gt;.com/api</kbd> |
   | OAuth Entity Name | Name to identify the OAuth entity record. |
   | OAuth Client ID | Application ID created during the GitLab application configuration. |
   | OAuth Client Secret | Secret created during the GitLab application configuration. |
   | OAuth Redirect URL | OAuth callback endpoint. The format of the redirect URL is: <kbd class="ph userinput">https://&lt;instance-name&gt;.service-now.com/api/sn_gitlab_spoke/gitlab_oauth_redirect/oauth?secureToken=&lt;Secure-Token&gt;</kbd>. Replace \<Instance-Name\> with the name of your ServiceNow instance and replace \<Secure-Token\> with the secure token you had generated in the ServiceNow instance. |
   [ ]

   {#gitlab-conf-temp__table_tfv_3d5_h5b}
7. Click Configure and Get OAuth Token.

*[\>]: and then