Zoho to HubSpot Migration: Field Mapping, Deal History and Cutover
Migrate Zoho CRM to HubSpot: map Leads, Accounts and Deals, keep notes and activity dates, choose Smart Transfer or imports, then reconcile and cut over.
Zoho CRM to HubSpot migrations rarely fail loudly. The counts look close, then a sales manager opens a deal and every note on it is dated the day of the import.
This guide covers the Zoho-specific decisions: module mapping, route choice and keeping deal history through cutover. Moving from Salesforce instead? Our Salesforce to HubSpot migration guide covers that data model.
Start With Zoho's Modules, Not HubSpot's Objects
Zoho keeps people in two modules. When a lead is converted, Zoho creates a Contact, an Account if the lead has a company name, and a Deal only if the user ticks that option, as its lead conversion guide explains. The same page warns: "A lead cannot be reverted once converted to contact or account."
HubSpot has one contacts object. Its own Smart Transfer mapping table sends both Zoho Leads and Zoho Contacts to HubSpot contacts, Accounts to companies and Deals to deals. Decide three things before anyone exports a file:
- Unconverted Leads. Import them as contacts at an early lifecycle stage, or archive stale ones outside HubSpot. A dropdown property such as
zoho_source_module(Lead or Contact) keeps them reportable. - Overlaps. If an email address exists in both modules, decide which values win and dedupe before import. Our duplicate contacts guide covers the clean-up if some slip through.
- Potentials. Accounts created before June 2016 may still call the Deals module Potentials, according to Zoho's deals overview.
Zoho's Lead Status is not a HubSpot lifecycle stage. Imported Lifecycle stage values must match the internal value or the English label (HubSpot import file rules), and HubSpot tools, including import, only move it forward unless it is cleared first (lifecycle stage documentation). Agree definitions first; our lifecycle stage model guide shows how.
Choose a Route: Smart Transfer or Export and Import
HubSpot Smart Transfer supports Zoho CRM directly. It sits under Data Management > Data Integration > Transfer data, only Super Admins can access it, the transfer is one-way, and a Data Hub subscription is required to transfer custom field mappings (Smart Transfer guide). Its audit reports record counts, pipelines, stages, fields and expected HubSpot property types before anything moves.
- Configuration creates workflows and switches them on. For Zoho, they include workflows that set the deal Create Date from Zoho's Created Time and add
zcrm_to migrated record IDs "to use with imports". - After the initial sync, it keeps running in the background. Plan when it stops.
- Zoho attachments, notes and deal line items move in a one-time post-sync transfer, and that data "won't automatically stay up to date".
Export and import gives more control over filtering and clean-up. Zoho's module export (Setup > Data Administration > Export) produces CSV or XLSX files. CSV is capped at 200,000 records per module in one go and XLSX at 50,000, and larger modules can be split using criteria on Created Time (Zoho export guide). The export lets you exclude the Record ID field. Do not: that ID is your migration key.
For everything at once, Zoho's Data Backup (Setup > Data Administration > Data Backup, administrators only) delivers data and attachments as separate ZIP folders, and the download link stays active for a maximum of seven days (Zoho data backup). Zoho notes the revamped backup is not yet in every data centre. HubSpot Starter, Professional and Enterprise accounts accept import files of up to 512 MB and 1,048,576 rows (import limits).
Free 30-Minute Migration Review
Moving off Zoho CRM?
We'll review your module mapping, pipelines and activity history plan before anything is exported, so the first test import is the right one.
Book Your Free Discovery Call →Map Fields, Picklists, Owners and Lookups
- Zoho record ID. Create
zoho_record_idon contacts, companies and deals and set it to require unique values. HubSpot accepts a unique value property as an import identifier alongside Record ID, Email and Company domain name (import identifiers). - Picklists to dropdowns. Recreate each picklist you keep as a dropdown select property. Import values must match an option's label or internal value, so create the options first and drop values nobody used.
- Owners. Create HubSpot users first, then map Zoho's owner field to the [Object] owner column using email addresses. Owners assigned by import are not notified.
- Pipelines and stages. New deals need Deal name, Pipeline and Deal stage, matching options that already exist in HubSpot. Set each stage's deal probability deliberately; it drives the weighted amount in board view (pipeline settings). With several Zoho pipelines, note that Smart Transfer adds a backfill workflow to "Address the lack of multi-pipeline support in HubSpot's Zoho integration", so check pipeline assignment afterwards.
- Lookups to associations. A Zoho lookup field links a record to one in another module. In HubSpot that relationship is an association, not a property. Put both records' identifiers in the same row, or use two files sharing a common column. Association labels, such as a decision-maker label on a contact-to-deal link, need a Professional or Enterprise subscription.
Keep Deal History, Notes and Attachments
Dates are where history gets lost. HubSpot's import guidance is blunt: "If you don't include this property, the Activity date values are automatically set to the date and time of the import." Map every activity's original Zoho timestamp to Activity date, and carry each deal's Zoho closing date into the HubSpot Close date property.
- Export activities deliberately. Zoho's export lets you pick Notes as a module, and Data Backup lists Tasks, Calls, Meetings and Emails separately from module data.
- Get activities right first time. HubSpot import can create but not update emails, meetings, notes and tasks, and emails, meetings and notes must be associated with an object (import tool overview).
- Plan attachments. On the file route, HubSpot only accepts existing files as a File ID in a file property, so files must be in HubSpot before the import that references them.
Bring consent across too: map Zoho's Email Opt Out field before anyone sends from HubSpot. Our HubSpot GDPR checklist covers subscription types and lawful basis for teams under UK GDPR, PECR or similar rules.
Test, Reconcile, Cut Over and Keep a Rollback
- Test import. Load a sample covering every module and pipeline, plus records with long histories. Check each by hand against Zoho.
- Reconcile. Compare record counts per object with Zoho's export history, which logs the number of records exported. Then compare open pipeline value per stage and note dates on named deals.
- Freeze. After an agreed cut-off, nobody edits Zoho. Export changes since the main load with a custom view or criteria, and load that delta before go-live.
- Rollback. Smart Transfer's Revert transfer deletes the settings and records it created, but not records synced through a standard sync connection. For file imports, the imports dashboard lets you delete records an import created, but updates to existing records cannot be reversed that way. Keep the Zoho backup and Zoho access until reconciliation is signed off.
For hands-on help with a Zoho move, see our HubSpot migration service.
Frequently Asked Questions
Can HubSpot migrate Zoho CRM data automatically?
Yes. HubSpot Smart Transfer supports Zoho CRM as a one-way transfer into HubSpot. Only Super Admins can use it, and transferring custom field mappings requires a Data Hub subscription.
What happens to Zoho Leads in HubSpot?
Smart Transfer maps them to HubSpot contacts. Decide their lifecycle stage before import, tag their source module and archive stale leads.
Will notes and activities keep their original dates?
Only if you map them. In a file import, activities without an Activity date value are dated at the time of the import, so map each original Zoho timestamp.
How do I move attachments from Zoho to HubSpot?
Smart Transfer moves them in a one-time post-sync transfer. On the file route, Zoho's Data Backup supplies them as a separate ZIP, and files must be in HubSpot before an import can reference them by File ID.
Can I undo a Zoho to HubSpot migration?
Partly. Smart Transfer can revert what it created, and the imports dashboard can delete records an import created. Updates to existing records cannot be reversed that way, so keep Zoho and its backup until sign-off.
Want a second pair of eyes on your setup?
Book a free 30-minute discovery call. We'll show you where we see the biggest leverage — no pitch deck, no fluff.
Book a Free Discovery Call →