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; CosmoLex works in matter 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 CosmoLex in month two.
The two systems, side by side
| HubSpot | CosmoLex | |
|---|---|---|
| Primary record | Contact | Matter |
| Grouping | Company associations | Client and contact links |
| Activity history | Engagements: notes, calls, emails, meetings | Notes, tasks and calendar |
| Documents | Attachments on records, plus the file manager | Documents on the matter |
| Getting data out | CSV export per object and a well-documented API. | CSV export; accounting data extracts separately. |
| Who administers it | None, though marketing usually owns it. | None. |
| Pricing | Free tier through enterprise seats. | Custom quoted. |
What breaks
- HubSpot works in contact records and CosmoLex works in matter records. That is a re-modelling exercise, and it is the first decision, not a mapping detail.
- Grouping changes: Company associations becomes Client and contact links. 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; CosmoLex expects notes, tasks and calendar.
- 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 CosmoLex:
- The general ledger and trust accounting are the reason firms chose it, and most targets do not replace them.
- Accounting and matter data have to reconcile after the move or the books do not tie.
- Historic trust transactions carry retention obligations of their own.
The field map
| Concept | In HubSpot | In CosmoLex | What to watch |
|---|---|---|---|
| Primary record | Contact | Matter | Different shape. Decide the mapping before any data moves. |
| Grouping | Company associations | Client and contact links | The target groups records differently, so grouping is created rather than copied. |
| Activity history | Engagements: notes, calls, emails, meetings | Notes, tasks and calendar | Expect partial fidelity. Types, timestamps and authorship survive; structure often does not. |
| Documents | Attachments on records, plus the file manager | Documents on the matter | 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 CosmoLex 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 CosmoLex 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 CosmoLex, 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 matter with the right metadata, and the post-cutover hygiene that otherwise becomes someone's Monday.
Caddi automation for these systems: HubSpot.
Related migrations
- Clio Grow to HubSpot
- Clio Manage to HubSpot
- Filevine to HubSpot
- HubSpot to Clio Grow
- HubSpot to Clio Manage
- HubSpot to Filevine
Migration without the manual pass
Move and reconcile HubSpot into CosmoLex
Caddi reads HubSpot, applies your field map, loads CosmoLex, then compares both sides record by record and reports the variances.
Frequently asked questions
How do you migrate from HubSpot to CosmoLex?
Audit the HubSpot data first, then map fields against fifty real records rather than against the schema, dry run the full set into a CosmoLex 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. CosmoLex then needs the records loaded in dependency order, with documents as a separate pass.
What does not transfer from HubSpot to CosmoLex?
HubSpot works in contact records and CosmoLex works in matter records. That is a re-modelling exercise, and it is the first decision, not a mapping detail. Grouping changes: Company associations becomes Client and contact links. 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; CosmoLex expects notes, tasks and calendar.
How long does a HubSpot to CosmoLex migration take?
Six to twelve weeks is realistic for a clean mid-size move, and three to six months where CosmoLex 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 CosmoLex afterwards?
None. 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.