Provider guides
GitLab
What’s Supported
Supported Actions
This connector supports:- Read Actions, including full historic backfill and incremental read for most of the supported objects.
- Write Actions.
- Proxy Actions, using the base URL
https://gitlab.com.
Supported Objects
The GitLab connector supports reading from the following objects:- admin/search/migrations
- application/appearance
- application/plan_limits
- application/settings
- applications
- audit_events
- broadcast_messages
- bulk_imports
- bulk_imports/entities
- deploy_keys
- deploy_tokens
- events
- experiments
- geo_nodes/status
- geo_sites
- geo_sites/status
- groups
- hooks
- issues
- issues_statistics
- license
- licenses
- member_roles
- merge_requests
- metadata
- namespaces
- pages/domains
- personal_access_tokens
- personal_access_tokens/self/associations
- project_aliases
- project_repository_storage_moves
- projects
- runners
- runners/all
- service_accounts
- sidekiq/compound_metrics
- sidekiq/job_stats
- sidekiq/process_metrics
- sidekiq/queue_metrics
- snippet_repository_storage_moves
- snippets
- snippets/all
- snippets/public
- templates/dockerfiles
- templates/gitignores
- templates/gitlab_ci_ymls
- templates/licenses
- todos
- topics
- users
- applications
- broadcast_messages
- chat/completions
- code_suggestions/completions
- deploy_keys
- geo_nodes
- geo_sites
- group_repository_storage_moves
- groups
- hooks
- member_roles
- organizations
- project_aliases
- project_repository_storage_moves
- projects
- runners
- security/vulnerability_exports
- service_accounts
- snippets
- todos/mark_as_done
- topics
- user/emails
- user/gpg_keys
- user/keys
- user/runners
- user/support_pin
- users
Example integration
For an example manifest file of an GitLab integration, visit our samples repo on Github.Using the connector
This connector uses GitLab Access Tokens for authentication, which means that you do not need to set up a Provider App before getting started. (Provider apps are only required for providers that use OAuth2 Authorization Code grant type.) Your customer can pick between: To start integrating with GitLab:- Create a manifest file like the example.
- Deploy it using the amp CLI.
- If you are using Read Actions, create a destination.
- Embed the InstallIntegration UI component. The UI component will prompt the customer for an Access token.
- Start using the connector!
- If your integration has Read Actions, you’ll start getting webhook messages.
- If your integration has Write Actions, you can start making API calls to our Write API.
- If your integration has Proxy Actions, you can start making Proxy API calls.