GitLab (Group Access Token)

🚀 Quickstart

Connect to GitLab with a Group Access Token in Nango and see data flow in 2 minutes.

Create the integration

In Nango (free signup), open Integrations -> Configure New Integration -> GitLab (Group Access Token).

Connect your GitLab group

Open Connections -> Add Test Connection -> Authorize, then enter your GitLab hostname, group ID, and Group Access Token. Later, you’ll let your users do the same directly from your app.

Call the GitLab API

Make your first request by fetching the authenticated bot user. Replace the placeholders with your Environment API key, integration ID from Integrations, and connection ID from Connections:

cURL
Node

curl "https://api.nango.dev/proxy/api/v4/user" \
  -H "Authorization: Bearer <NANGO-API-KEY>" \
  -H "Provider-Config-Key: <INTEGRATION-ID>" \
  -H "Connection-Id: <CONNECTION-ID>"

Install Nango’s backend SDK with npm i @nangohq/node. Then run:

import { Nango } from '@nangohq/node';

const nango = new Nango({ apiKey: '<NANGO-API-KEY>' });

const res = await nango.get({
    endpoint: '/api/v4/user',
    providerConfigKey: '<INTEGRATION-ID>',
    connectionId: '<CONNECTION-ID>'
});

console.log(res.data);

Or fetch credentials with the Node SDK or API.✅ You’re connected! Open Logs in Nango to inspect requests.

Implement Nango in your app

Follow our Auth implementation guide to integrate Nango in your app.To create a Group Access Token, follow the connect guide linked below.

GitLab Group Access Token notes

Group Access Tokens authenticate as an auto-provisioned bot user inside the group. The token remains associated with the group when individual members leave.

The token grants access to the group and its subgroups and projects, not the wider GitLab instance. Create one connection per group when you need access to multiple unrelated groups.

GitLab webhook payloads do not contain a Nango connection ID. Append ?nangoConnectionId=<connectionId> to the Nango webhook URL when registering a project or group webhook. Configure a signing token on the GitLab webhook and store the same value as webhookSecret in the Nango connection metadata.

Overview

900+ APIs & Integrations

GitLab (Group Access Token)

🚀 Quickstart