Gitlab - Nango Docs

Overview

Pre-built tooling

Pre-built integrations

Access requirements

Setup guide

Useful links

API gotchas

Pre-built tooling

✅ Authorization

Tools	Status
Pre-built authorization (OAuth)	✅
Credentials auto-refresh	✅
Auth parameters validation	✅
Pre-built authorization UI	✅
Custom authorization UI	✅
Expired credentials detection	✅

✅ Read & write data

Tools	Status
Pre-built integrations	✅
API unification	✅
2-way sync	✅
Webhooks from Nango on data modifications	✅
Real-time webhooks from 3rd-party API	✅
Proxy requests	✅

✅ Observability & data quality

Tools	Status
HTTP request logging	✅
End-to-end type safety	✅
Data runtime validation	✅
OpenTelemetry export	✅
Slack alerts on errors	✅
Integration status API	✅

✅ Customization

Tools	Status
Create or customize use-cases	✅
Pre-configured pagination	🚫 (time to contribute: <48h)
Pre-configured rate-limit handling	🚫 (time to contribute: <48h)
Per-customer configurations	✅

Releases

Function name	Description	Type
`releases`	Sync releases from GitLab.	Sync

Others

Function name	Description	Type
`cancel-pipeline`	Cancel a GitLab pipeline.	Tool
`create-branch`	Create a branch in GitLab.	Tool
`create-commit`	Create a commit in GitLab	Tool
`create-file`	Create a GitLab repository file.	Tool
`create-group`	Create a group in GitLab.	Tool
`create-issue`	Create an issue in GitLab.	Tool
`create-merge-request`	Create a merge request in GitLab	Tool
`create-project`	Create a project in GitLab.	Tool
`create-pipeline`	Create a pipeline in GitLab.	Tool
`create-release`	Create a release in GitLab.	Tool
`delete-branch`	Delete or archive a branch in GitLab.	Tool
`delete-file`	Delete a GitLab repository file.	Tool
`delete-group`	Delete or archive a group in GitLab.	Tool
`delete-issue`	Delete or archive a issue in GitLab.	Tool
`delete-merge-request`	Delete a merge request in GitLab.	Tool
`delete-pipeline`	Delete a pipeline in GitLab. This permanently deletes the pipeline and all immediately related objects, such as builds, logs, artifacts, and triggers. This action cannot be undone.	Tool
`delete-project`	Delete or archive a project in GitLab.	Tool
`delete-release`	Delete a release in GitLab.	Tool
`get-branch`	Retrieve a single branch from GitLab.	Tool
`get-commit`	Retrieve a single commit from GitLab.	Tool
`get-file`	Fetch a GitLab repository file.	Tool
`get-group`	Retrieve a single group from GitLab.	Tool
`get-issue`	Retrieve a single issue from GitLab.	Tool
`get-job`	Retrieve a single job from GitLab.	Tool
`get-merge-request`	Retrieve a single merge request from GitLab.	Tool
`get-pipeline`	Retrieve a single pipeline from GitLab.	Tool
`get-project`	Retrieve a single project from GitLab.	Tool
`get-release`	Retrieve a single release from GitLab.	Tool
`list-branches`	List branches from GitLab.	Tool
`list-commits`	List commits from GitLab.	Tool
`list-groups`	List groups from GitLab.	Tool
`list-issues`	List issues from GitLab	Tool
`list-jobs`	List jobs from GitLab.	Tool
`list-merge-requests`	List merge requests from GitLab.	Tool
`list-pipelines`	List pipelines from GitLab.	Tool
`list-projects`	List projects from GitLab.	Tool
`list-releases`	List releases from GitLab.	Tool
`retry-job`	Retry a GitLab CI job.	Tool
`update-file`	Update a GitLab repository file.	Tool
`update-group`	Update a group in GitLab	Tool
`update-issue`	Update an issue in GitLab.	Tool
`update-merge-request`	Update a merge request in GitLab.	Tool
`update-project`	Update a project in GitLab.	Tool
`update-release`	Update a release in GitLab.	Tool
`branches`	Sync branches from GitLab	Sync
`commits`	Sync commits from GitLab.	Sync
`groups`	Sync groups from GitLab.	Sync
`issues`	Sync issues from GitLab	Sync
`jobs`	Sync jobs from GitLab.	Sync
`merge-requests`	Sync merge requests from GitLab	Sync
`pipelines`	Sync pipelines from GitLab.	Sync
`projects`	Sync projects from GitLab	Sync

Nango has a Nango-managed OAuth app you can use in development and production. Select it when you create the integration.

Access requirements

Pre-Requisites	Status	Comment
Paid dev account	❓
Paid test account	❓
Partnership	❓
App review	❓
Security audit	❓

Setup guide

No setup guide yet.

Need help getting started? Get help in the community.

Contribute improvements to the setup guide by editing this page

Useful links

Contribute useful links by editing this page

API gotchas

GitLab webhook payloads do not contain a Nango connection ID, and a single connection can span many GitLab projects. To route a project or group webhook to a specific connection, append ?nangoConnectionId=<connectionId> to the Nango webhook URL when registering the hook in GitLab. Nango reads the X-Gitlab-Event header (for example, Issue Hook, Merge Request Hook, or Note Hook) as the event type. Configure a signing token on the GitLab hook and store the same value as webhookSecret in the Nango connection’s metadata. For GitLab versions before 19.0, configure a secret token and store it in the same metadata field; Nango falls back to validating X-Gitlab-Token when no signature is present.

Contribute API gotchas by editing this page