HubSpot
Import companies, contacts, deals, quotes, activity and email templates from HubSpot into XODASH, and learn what an import changes.
The HubSpot integration copies your CRM data from HubSpot into XODASH. It is an import, one way from HubSpot to XODASH: nothing is written back to HubSpot. Use it when you move to XODASH, and run it again to bring in later changes.
Who can do this
Connecting HubSpot and running an import need permission to manage CRM settings, which workspace Admins have.
Connect HubSpot
HubSpot connects with a private app access token.
Create a private app in HubSpot
In HubSpot, create a private app with read access to the data you want to import, and copy its access token.
Open the HubSpot section
In XODASH, open CRM settings → Integrations and find HubSpot.
Paste the token
Paste the token (it starts with pat-) and choose Connect. HubSpot then shows Connected.
Run an import
Open the import
In the HubSpot section, choose Import.
Choose what to import
Under Select what to import, pick any of Companies, Contacts, Deals, Quotes, Engagements and Templates.
Start it
Choose Start Import. The progress bar shows which kind of record is importing. Large accounts can take a while; you can leave the page.
Check the results
When it says Import complete, review the counts for each kind of record and any warnings, such as a deal whose HubSpot stage isn't in your pipeline yet.
Import companies and contacts before deals, and deals before quotes: a quote without its deal in XODASH is skipped with "Its deal is not in XODASH yet. Import deals first."
What an import does
Companies and contacts
- A HubSpot company is matched to an XODASH company by domain, then by name, and created only when there is no match. A contact is matched by any of their email addresses within their company.
- When a match isn't clear, XODASH doesn't guess. It queues the record for review instead of merging. See Duplicates.
- Imported people and companies are shared records, not private ones.
- HubSpot owners are matched to XODASH users by email address and become the records' owners.
Your edits are kept
- A value you edit by hand in XODASH always wins. A later import doesn't overwrite it.
- Running the import again updates records it imported before. A record you deleted in XODASH is neither updated nor created again.
Company stages
- HubSpot fills a company's stage only when it is blank, and never replaces one.
- A new contact takes its HubSpot lifecycle stage once, when it is first imported.
- Importing deals doesn't move companies to a new stage: imported deals are history. Only a new open deal or a stage change brought in by a later import counts, as it would in XODASH. See Company stages.
Deals, quotes and activity
- HubSpot's deal stages are added to your pipeline when you don't have them yet. A deal whose stage can't be matched goes into your first open stage, with a warning.
- Quotes come in with their line items.
- Engagements bring in HubSpot calls, emails, meetings, notes and tasks as activity on the timeline.
Import email templates
HubSpot doesn't share sales templates through its API, so they are imported by hand.
Open Import Templates
In the HubSpot section, choose Import Templates and copy the script shown.
Run it in HubSpot
Open your HubSpot Templates page, open the browser's developer console, paste the script and press Enter. It copies your templates to the clipboard.
Paste and import
Paste the copied text into the box in XODASH and choose Import Templates.
If an import fails
The import shows a plain sentence for what went wrong, for example:
- "HubSpot is rate limiting requests. Run the import again later."
- "HubSpot rejected the access token. Reconnect HubSpot and run it again."
- "HubSpot denied access to this data. Check the private app's scopes, then run it again."
Choose Disconnect to remove the token. Records already imported stay in XODASH.