docs/integrations/sources/gitlab.md
This page contains the setup guide and reference information for the Gitlab Source connector.
For Airbyte Cloud:
For Airbyte Open Source:
Create a GitLab Account or set up a local instance of GitLab.
<!-- env:oss -->Airbyte Open Source additional setup steps
Log into GitLab and then generate a personal access token. Your token should have the read_api scope, that Grants read access to the API, including all groups and projects, the container registry, and the package registry.
For Airbyte Cloud:
Authenticate your GitLab account by selecting Oauth or Personal Access Token for Authentication.gitlab.com (default).airbytehq for single group, airbytehq another-repo for multiple groups.airbytehq/airbyte.Note: You can specify either Group IDs or Project IDs in the source configuration. If both fields are blank, the connector will retrieve a list of all the groups that are accessible to the configured token and ingest as normal.
<!-- /env:cloud --> <!-- env:oss -->For Airbyte Open Source:
The Gitlab Source connector supports the following sync modes:
This connector outputs the following streams:
GitLab source works with GitLab API v4. It can also work with self-hosted GitLab API v4.
Gitlab has the rate limits, but the Gitlab connector should not run into Gitlab API limitations under normal usage. Please create an issue if you see any rate limit issues that are not automatically retried successfully.
| Version | Date | Pull Request | Subject |
|---|---|---|---|
| 4.4.23-rc.1 | 2026-03-07 | 70858 | Add HTTPAPIBudget and concurrency_level for improved sync performance |
| 4.4.22 | 2026-02-24 | 73774 | Update dependencies |
| 4.4.21 | 2026-02-17 | 73401 | Update dependencies |
| 4.4.20 | 2026-02-10 | 71398 | Update dependencies |
| 4.4.19 | 2026-02-05 | 72262 | Update CDK version from 7.6.1 to 7.6.5 |
| 4.4.18 | 2025-12-18 | 70698 | Update dependencies |
| 4.4.17 | 2025-12-11 | 70839 | Change check stream from projects to groups to fix timeout for large GitLab organizations |
| 4.4.16 | 2025-11-25 | 69875 | Update dependencies |
| 4.4.15 | 2025-11-18 | 69411 | Update dependencies |
| 4.4.14 | 2025-10-29 | 69030 | Update dependencies |
| 4.4.13 | 2025-10-21 | 68297 | Update dependencies |
| 4.4.12 | 2025-10-14 | 68000 | Update dependencies |
| 4.4.11 | 2025-10-07 | 67266 | Update dependencies |
| 4.4.10 | 2025-09-30 | 66076 | Update dependencies |
| 4.4.9 | 2025-09-10 | 65997 | Update dependencies |
| 4.4.8 | 2025-08-26 | 65556 | Update dependencies |
| 4.4.7 | 2025-08-23 | 65362 | Update dependencies |
| 4.4.6 | 2025-08-09 | 64579 | Update dependencies |
| 4.4.5 | 2025-08-02 | 64222 | Update dependencies |
| 4.4.4 | 2025-07-26 | 63913 | Update dependencies |
| 4.4.3 | 2025-07-19 | 63489 | Update dependencies |
| 4.4.2 | 2025-07-15 | 63309 | Adds type property to config_normalization_rules in manifest |
| 4.4.1 | 2025-07-12 | 61471 | Update dependencies |
| 4.4.0 | 2025-07-07 | 62831 | Promoting release candidate 4.4.0-rc.1 to a main version. |
| 4.4.0-rc.1 | 2025-07-02 | 62480 | Migrate to manifest-only |
| 4.3.7 | 2025-05-31 | 57264 | Update dependencies |
| 4.3.6 | 2025-03-29 | 54945 | Update dependencies |
| 4.3.5 | 2025-02-22 | 51695 | Update dependencies |
| 4.3.4 | 2025-01-11 | 44671 | Starting with this version, the Docker image is now rootless. Please note that this and future versions will not be compatible with Airbyte versions earlier than 0.64 |
| 4.3.3 | 2024-08-17 | 44207 | Update dependencies |
| 4.3.2 | 2024-08-12 | 43856 | Update dependencies |
| 4.3.1 | 2024-08-03 | 43058 | Update dependencies |
| 4.3.0 | 2024-07-31 | 42920 | Migrate to CDK v4.1.0 |
| 4.2.2 | 2024-07-27 | 42601 | Update dependencies |
| 4.2.1 | 2024-07-20 | 42295 | Update dependencies |
| 4.2.0 | 2024-07-17 | 42085 | Migrate to CDK v2.4.0 |
| 4.1.0 | 2024-07-17 | 42021 | Migrate to CDK v1.8.0 |
| 4.0.8 | 2024-07-13 | 41835 | Update dependencies |
| 4.0.7 | 2024-07-10 | 41470 | Update dependencies |
| 4.0.6 | 2024-07-09 | 41100 | Update dependencies |
| 4.0.5 | 2024-07-06 | 40894 | Update dependencies |
| 4.0.4 | 2024-06-25 | 40417 | Update dependencies |
| 4.0.3 | 2024-06-22 | 40102 | Update dependencies |
| 4.0.2 | 2024-04-24 | 36637 | Schema descriptions and CDK 0.80.0 |
| 4.0.1 | 2024-04-23 | 37505 | Set error code 500 as retryable |
| 4.0.0 | 2024-03-25 | 35989 | Migrate to low-code |
| 3.0.0 | 2024-01-25 | 34548 | Fix merge_request_commits stream to return commits for each merge request |
| 2.1.2 | 2024-02-12 | 35167 | Manage dependencies with Poetry. |
| 2.1.1 | 2024-01-12 | 34203 | prepare for airbyte-lib |
| 2.1.0 | 2023-12-20 | 33676 | Add fields to Commits (extended_trailers), Groups (emails_enabled, service_access_tokens_expiration_enforced) and Projects (code_suggestions, model_registry_access_level) streams |
| 2.0.0 | 2023-10-23 | 31700 | Add correct date-time format for Deployments, Projects and Groups Members streams |
| 1.8.4 | 2023-10-19 | 31599 | Base image migration: remove Dockerfile and use the python-connector-base image |
| 1.8.3 | 2023-10-18 | 31547 | Add validation for invalid groups_list and/or projects_list |
| 1.8.2 | 2023-10-17 | 31492 | Expand list of possible error status codes when handling expired access_token |
| 1.8.1 | 2023-10-12 | 31375 | Mark start_date as optional, migrate groups and projects to array |
| 1.8.0 | 2023-10-12 | 31339 | Add undeclared fields to streams schemas, validate date/date-time format in stream schemas |
| 1.7.1 | 2023-10-10 | 31210 | Added expired access_token handling, while checking the connection |
| 1.7.0 | 2023-08-08 | 29203 | Add Deployments stream |
| 1.6.0 | 2023-06-30 | 27869 | Add shared_runners_setting field to groups |
| 1.5.1 | 2023-06-24 | 27679 | Fix formatting |
| 1.5.0 | 2023-06-15 | 27392 | Make API URL an optional parameter in spec. |
| 1.4.2 | 2023-06-15 | 27346 | Partially revert changes made in version 1.0.4, disallow http calls in cloud. |
| 1.4.1 | 2023-06-13 | 27351 | Fix OAuth token expiry date. |
| 1.4.0 | 2023-06-12 | 27234 | Skip stream slices on 403/404 errors, do not fail syncs. |
| 1.3.1 | 2023-06-08 | 27147 | Improve connectivity check for connections with no projects/groups |
| 1.3.0 | 2023-06-08 | 27150 | Update stream schemas |
| 1.2.1 | 2023-06-02 | 26947 | New field name added to Pipelines and PipelinesExtended stream schema |
| 1.2.0 | 2023-05-17 | 22293 | Preserve data in records with flattened keys |
| 1.1.1 | 2023-05-23 | 26422 | Fix error 404 Repository Not Found when syncing project with Repository feature disabled |
| 1.1.0 | 2023-05-10 | 25948 | Introduce two new fields in the Projects stream schema |
| 1.0.4 | 2023-04-20 | 21373 | Accept api_url with or without scheme |
| 1.0.3 | 2023-02-14 | 22992 | Specified date formatting in specification |
| 1.0.2 | 2023-01-27 | 22001 | Set AvailabilityStrategy for streams explicitly to None |
| 1.0.1 | 2023-01-23 | 21713 | Fix missing data issue |
| 1.0.0 | 2022-12-05 | 7506 | Add OAuth2.0 authentication option |
| 0.1.12 | 2022-12-15 | 20542 | Revert HttpAvailability changes, run on cdk 0.15.0 |
| 0.1.11 | 2022-12-14 | 20479 | Use HttpAvailabilityStrategy + add unit tests |
| 0.1.10 | 2022-12-12 | 20384 | Fetch groups along with their subgroups |
| 0.1.9 | 2022-12-11 | 20348 | Fix 403 error when syncing EpicIssues stream |
| 0.1.8 | 2022-12-02 | 20023 | Fix duplicated records issue for Projects stream |
| 0.1.7 | 2022-12-01 | 19986 | Fix GroupMilestones stream schema |
| 0.1.6 | 2022-06-23 | 13252 | Add GroupIssueBoards stream |
| 0.1.5 | 2022-05-02 | 11907 | Fix null projects param and container_expiration_policy |
| 0.1.4 | 2022-03-23 | 11140 | Ingest All Accessible Groups if not Specified in Config |
| 0.1.3 | 2021-12-21 | 8991 | Update connector fields title/description |
| 0.1.2 | 2021-10-18 | 7108 | Allow all domains to be used as api_url |
| 0.1.1 | 2021-10-12 | 6932 | Fix pattern field in spec file, remove unused fields from config files, use cache from CDK |
| 0.1.0 | 2021-07-06 | 4174 | Initial Release |