The hard part of this move is not the export. It is the difference in how the two systems think. HubSpot works in contact records; Neos works in case records. Get that mapping wrong and every report built on it afterwards is wrong too. This page covers the field map, what does not survive, what it costs, and the reconciliation step that decides whether anyone trusts Neos in month two.
The two systems, side by side
| HubSpot | Neos | |
|---|---|---|
| Primary record | Contact | Case |
| Grouping | Company associations | Case type, plan and parties |
| Activity history | Engagements: notes, calls, emails, meetings | Notes, tasks and plan-driven deadlines |
| Documents | Attachments on records, plus the file manager | Documents on the case |
| Getting data out | CSV export per object and a well-documented API. | Vendor-assisted export plus API access. |
| Who administers it | None, though marketing usually owns it. | An internal operations owner. |
| Pricing | Free tier through enterprise seats. | Custom quoted. |
What breaks
- HubSpot works in contact records and Neos works in case records. That is a re-modelling exercise, and it is the first decision, not a mapping detail.
- Grouping changes: Company associations becomes Case type, plan and parties. Somebody has to define what a group means in the target before load.
- Activity history moves with partial fidelity. HubSpot stores it as engagements: notes, calls, emails, meetings; Neos expects notes, tasks and plan-driven deadlines.
- Automations, reports, dashboards and permissions never transfer. Budget them as build work.
- Every connected system has to be repointed and retested: the DMS, billing, e-signature and the shared inbox.
Known hazards on each side
Leaving HubSpot:
- Associations between contacts, companies and deals are what carry structure, and flat exports lose them.
- Marketing email and workflow history does not migrate to a vertical system.
- Property names drift over time because anyone can create them.
Arriving in Neos:
- Case plans generate deadlines, and the plan logic does not export with the dates.
- Party and provider records are richer than most targets expect.
- Legacy Needles data carried into Neos may hold two generations of field conventions.
The field map
| Concept | In HubSpot | In Neos | What to watch |
|---|---|---|---|
| Primary record | Contact | Case | Different shape. Decide the mapping before any data moves. |
| Grouping | Company associations | Case type, plan and parties | The target groups records differently, so grouping is created rather than copied. |
| Activity history | Engagements: notes, calls, emails, meetings | Notes, tasks and plan-driven deadlines | Expect partial fidelity. Types, timestamps and authorship survive; structure often does not. |
| Documents | Attachments on records, plus the file manager | Documents on the case | Usually a separate extract and load from the record data. |
| Owner and assignment | Assigned user or advisor fields | Assigned user or team fields | Map departed staff explicitly. Records assigned to nobody disappear from every view. |
| Custom fields | Firm-specific fields added over time | Created to match, or consciously dropped | The audit here is the work. Undocumented fields that reports depend on are the usual surprise. |
Cost and timeline
| Phase | Typical range |
|---|---|
| Data audit and cleanup | $3,000 to $25,000 |
| Migration execution | $5,000 to $50,000 |
| Target configuration | Two to six weeks |
| Ongoing administration | Absorbed by existing operations staff |
The five phases
- Audit HubSpot. Count records per object, find duplicates and orphans, and decide what does not come with you. Get that decision signed off before mapping.
- Map against real records. Use the table above as the starting point, then walk fifty live records field by field.
- Dry run into a Neos sandbox. Load the full set, not a sample. Sample loads hide the failures that only appear at volume.
- Cut over on a quiet window. Freeze writes in HubSpot, load, repoint every integration, unfreeze. Keep HubSpot read-only for at least a quarter.
- Reconcile. Compare Neos to HubSpot record by record and field by field, and produce a variance report.
The full version of this plan, with the failure evidence behind it, is in the CRM migration playbook.
The compliance clause
State retention rules and the firm's duties over the client file survive the migration. A matter that lands in the target without its history is a records gap, not a cosmetic issue. Keep the field map, the variance report and the mapping sign-offs with the records, because the decisions you made in phase two are part of the record too.
Where Caddi fits
Caddi does the mechanical half and then keeps doing it. Show it the task once and it reads HubSpot, applies your field map, loads Neos, and then compares both sides record by record and hands back a variance report you can act on. Because it runs over APIs across your stack, the same agent covers the parts a migration tool ignores: documents filed to the right case with the right metadata, and the post-cutover hygiene that otherwise becomes someone's Monday.
Caddi automation for these systems: HubSpot and Neos.
Related migrations
- Clio Grow to HubSpot
- Clio Grow to Neos
- Clio Manage to HubSpot
- Clio Manage to Neos
- Filevine to HubSpot
- Filevine to Neos
Migration without the manual pass
Move and reconcile HubSpot into Neos
Caddi reads HubSpot, applies your field map, loads Neos, then compares both sides record by record and reports the variances.
Frequently asked questions
How do you migrate from HubSpot to Neos?
Audit the HubSpot data first, then map fields against fifty real records rather than against the schema, dry run the full set into a Neos sandbox, cut over on a quiet window with writes frozen, and reconcile record by record afterwards. CSV export per object and a well-documented API. Neos then needs the records loaded in dependency order, with documents as a separate pass.
What does not transfer from HubSpot to Neos?
HubSpot works in contact records and Neos works in case records. That is a re-modelling exercise, and it is the first decision, not a mapping detail. Grouping changes: Company associations becomes Case type, plan and parties. Somebody has to define what a group means in the target before load. Activity history moves with partial fidelity. HubSpot stores it as engagements: notes, calls, emails, meetings; Neos expects notes, tasks and plan-driven deadlines.
How long does a HubSpot to Neos migration take?
Six to twelve weeks is realistic for a clean mid-size move, and three to six months where Neos is being implemented at the same time. Firms with years of history in HubSpot should budget several weeks of cleanup before any data moves.
Who administers Neos afterwards?
An internal operations owner. That is one of the reasons this move is lighter than a platform migration.
What are the compliance implications for law firms?
State retention rules and duties over the client file survive the migration. A gap in matter history is a finding, not a cosmetic issue, so keep the field map, the variance report and the sign-offs with the records.