CRM
HubSpot
Read and manage HubSpot contacts, companies, and deals.
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 an owner or administrator of your Atlas workspace.
- You can sign in to your HubSpot account and approve access for Atlas.
- Atlas looks after the HubSpot app on its side, so there is nothing for you to create or copy.
How to connect
Open HubSpot in Integrations
In Atlas, open Integrations and select HubSpot.
Press Connect
Atlas sends you to HubSpot to sign in. Sign in with the account you want to connect.
Approve access
Review the permissions that HubSpot lists and approve them. Atlas returns you to the connector page, which then shows the connection.
Check the connection
Select Test connection on the connector page. A passing result means Atlas can read from HubSpot.
Permissions Atlas asks for
crm.objects.contacts.readcrm.objects.contacts.writecrm.objects.companies.read crm.objects.companies.writecrm.objects.deals.read crm.objects.deals.writecrm.objects.owners.readoauthSetup checklist
- Confirm you are an owner or administrator of your Atlas workspace.
- Open Integrations and select the connector.
- Press Connect and sign in to HubSpot.
- Review the permissions that HubSpot lists and approve them.
- Select Test connection and read the result.
Troubleshooting
INVALID_AUTHENTICATION
The saved sign-in was revoked. Reconnect from Atlas.
Connect says HubSpot is not available yet
Atlas has not enabled HubSpot for this deployment, so there is nothing for you to configure. Check again later.
The sign-in was cancelled
If you close the HubSpot screen or choose Cancel, Atlas does not connect. Press Connect again and approve the access.
Atlas asks you to reconnect
HubSpot can end a connection when access is revoked or a password changes. Press Reconnect on the connector page and approve the access again.
Event notifications
Atlas registers a HubSpot event subscription for each type of record and checks the signature that HubSpot sends with each event.
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
- Click Disconnect on the Atlas HubSpot connector page.
- In HubSpot, open Settings, Integrations, Connected apps and uninstall Atlas Connector.
- Atlas deletes cached HubSpot object metadata within 24 hours of disconnect.
When you are ready, open the live connector page and press Connect to finish connecting HubSpot.
Open the HubSpot connector page