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
    HubSpot logo

    CRM

    HubSpot

    Sync HubSpot contacts, companies, and deals with Atlas Growth records so sales and operations share one source of truth.

    AuthOAuth 2.0UpdatesReal-timeAvailable

    What this connector does

    • Sync contacts, companies, and deals into Atlas Growth records.
    • Reflect deal stage, owner, and amount changes across both systems after mapping approval.
    • Attach Atlas tasks to HubSpot records as engagements.
    • Listen for object change events to keep the deal room live.

    Before you begin

    • You are a Super Admin in the HubSpot account.
    • You can create developer apps on the HubSpot Developer portal.
    • You have a sandbox HubSpot account for first validation.

    Get your credentials

    1

    Open the HubSpot developer dashboard

    Sign in with the developer account associated with your HubSpot org. developers.hubspot.com

    2

    Create an app

    Click Create app, name it Atlas Connector, and save.

    3

    Configure auth and scopes

    Under Auth, add Redirect URL https://YOUR-ATLAS-HOST/oauth/callback/hubspot. Select the scopes listed below.

    4

    Install on the production account

    Click Install app and sign in with the production account owner to approve the scopes.

    5

    Copy the client id and secret

    From Auth, copy Client ID and Client Secret into the Atlas HubSpot connector settings page.

    Required scopes and permissions

    CRM objects readcrm.objects.contacts.read
    CRM objects writecrm.objects.contacts.write
    Companiescrm.objects.companies.read crm.objects.companies.write
    Dealscrm.objects.deals.read crm.objects.deals.write
    OAuth refreshoauth

    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_AUTHENTICATION

      Refresh token has been revoked. Reconnect from Atlas.

    • Required scope missing

      Add the scope under Auth, then click Install on production again to grant it.

    • Sandbox vs production confusion

      A developer test account is not the production org. Install the app on production for live sync.

    Webhooks

    Atlas registers a HubSpot webhook subscription per object type and validates the X-HubSpot-Signature header.

    Events Atlas listens for

    • contact.creation
    • contact.propertyChange
    • deal.creation
    • deal.propertyChange

    Provider docs: https://developers.hubspot.com/docs/api/webhooks

    Disconnect and data deletion

    1. Click Disconnect on the Atlas HubSpot connector page.
    2. In HubSpot, open Settings, Integrations, Connected apps and uninstall Atlas Connector.
    3. Atlas deletes cached HubSpot object metadata within 24 hours of disconnect.

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

    Open the HubSpot 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