AtlasWork, planned itself.

    The AI-native, all-in-one work platform. Tasks, projects, CRM, contracts, and analytics in one calm workspace.

    System status
    • SSO
    • SCIM
    • Two-factor sign-in
    • Audit log

    Product

    • Overview
    • PDF tools
    • Diagram tools
    • People & HR
    • Integrations
    • Marketplace
    • Pricing

    Resources

    • Guides
    • Glossary
    • Compare
    • Docs
    • API reference
    • Support
    • Changelog
    • Status

    Company

    • About
    • Careers
    • Press
    • Contact

    Legal & trust

    • Trust center
    • Security
    • Privacy
    • Terms
    • DPA
    • GDPR
    • SLA
    • Refunds
    • Google API data
    Atlas, a product by wrxstack.com·© 2026 wrxstack·All rights reserved
    PrivacyTermsSecurityStatus

    You are in control of your cookies

    Atlas uses strictly necessary cookies to keep you signed in. With your consent, we add anonymized product analytics, conversion attribution, and remembered preferences. Change your mind any time at /privacy/cookies.

    Off until you agree · Change it any time

    • Necessaryalways on
    • Analyticsopt-in
    • Marketingopt-in
    • Preferencesopt-in
    Skip to documentation
    Docs
    Back to Atlas

    Start here

    • Overview

    Developer

    • REST API guide
    • Authentication
    • API reference
    • MCP (AI agents)
    • MCP tools reference
    • SDKs
    • Quick actions
    • Changelog

    Webhooks

    • Overview
    • Quickstart
    • Events
    • Payloads and headers
    • Security and signing
    • Delivery and retries
    • Managing via API

    Connect

    • Connectors
    • Integrations

    Product

    • Collaboration and chat
    • Signing in and security
    • Client portal

    Reference

    • Glossary
    • Keyboard shortcuts
    • Module reference
    GitLab logo

    Developer

    GitLab

    Pull GitLab merge requests, issues, and pipeline status into Atlas so engineering progress lives next to project plans.

    AuthOAuth 2.0UpdatesReal-timeAvailable

    What this connector does

    • Link merge requests and issues to Atlas tasks.
    • Read project, branch, and pipeline metadata for evidence rows.
    • Watch merge request events to update Atlas task state.
    • Post Atlas task links back to merge request descriptions.

    Before you begin

    • You are an owner or maintainer of the GitLab group that contains the projects to connect.
    • Your GitLab plan allows OAuth applications at the group or instance level.
    • You can create webhooks on projects.

    Get your credentials

    1

    Open GitLab application settings

    Open User Settings, Applications for a personal install, or Group Settings, Applications for a group-wide install. gitlab.com applications

    2

    Create a new application

    Name it Atlas Connector. Set Redirect URI to https://YOUR-ATLAS-HOST/oauth/callback/gitlab.

    3

    Pick scopes

    Select api and read_user. For self-hosted GitLab also confirm the Atlas hostname is allowed by your CSP.

    4

    Save and copy credentials

    Click Save application. Copy the Application ID and Secret into the Atlas GitLab connector settings page.

    5

    Set the GitLab base URL

    If you use self-managed GitLab, set the base URL to https://gitlab.example.com in the Atlas connector settings before clicking Connect.

    Required scopes and permissions

    Full API accessapi
    Read user identityread_user
    Read repository contentread_repository

    Setup checklist

    1. Create the provider app in a sandbox or development workspace.
    2. Add the Atlas redirect URL to the provider app configuration.
    3. Copy the client id, client secret, or API key.
    4. Paste the credentials into the Atlas connector settings page.
    5. Click Connect and complete the provider sign-in screen.
    6. Run Test connection from the connector page to verify health.

    Troubleshooting

    • invalid_grant

      The OAuth code expired or was already used. Retry the connect flow once.

    • redirect_uri does not match

      GitLab compares the Redirect URI string exactly. Update the application and retry.

    • self-managed CORS errors

      Add YOUR-ATLAS-HOST to GitLab Admin Area, Settings, Network, Outbound requests allowlist.

    Webhooks

    Atlas creates a project-scoped webhook secret per connected project and validates the GitLab token header on every event.

    Events Atlas listens for

    • Push events
    • Merge request events
    • Issue events
    • Pipeline events

    Provider docs: https://docs.gitlab.com/ee/user/project/integrations/webhooks.html

    Disconnect and data deletion

    1. Click Disconnect on the Atlas GitLab connector page.
    2. Open Applications and remove the Atlas Connector authorization.
    3. Delete the project webhook in Project Settings, Webhooks if you want to stop event delivery immediately.

    Once you have the credentials above, paste them into the live connector page to finish connecting GitLab.

    Open the GitLab connector page

    On this page

    • What this connector does
    • Before you begin
    • Get your credentials
    • Required scopes and permissions
    • Setup checklist
    • Troubleshooting
    • Webhooks
    • Disconnect and data deletion