AtlasWork, planned itself.

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

  • SOC 2 II
  • ISO 27001
  • HIPAA
  • GDPR

Product

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

Resources

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

Company

  • About
  • Careers
  • Press
  • Contact

Legal & trust

  • Trust center
  • Security
  • Privacy
  • Terms
  • DPA
  • GDPR
  • SLA
  • Refunds
Atlas, a product by wrxstack.com·© 2026 wrxstack·All rights reserved
Made in India
Skip to documentation
AtlasDocs
Back to Atlas

Start here

  • Overview

Developer

  • REST API
  • MCP (AI agents)
  • SDKs
  • Quick actions

Connect

  • Connectors
  • Integrations

Reference

  • Keyboard shortcuts
  • Module reference

HubSpotCRM

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

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

Screenshot placeholder
2

Create an app

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

Screenshot placeholder
3

Configure auth and scopes

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

Screenshot placeholder
4

Install on the production account

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

Screenshot placeholder
5

Copy the client id and secret

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

Screenshot placeholder

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.

Ready to connect HubSpot?

Paste the credentials you copied above into the live connector page.

Open the connector page