CRM migration
Field-level mapping, validation, and rollback between Merlin and Nutshell. We move data and schema; workflows are rebuilt natively in Nutshell.
Merlin
Source
Nutshell
Destination
Compatibility
5 of 8
objects map 1:1 between Merlin and Nutshell.
Complexity
BStandard
Timeline
2-4 weeks
Overview
This migration is structurally distinct from standard CRM-to-CRM moves because Merlin is not a CRM—it has no Contacts, Companies, Opportunities, or Pipeline Stages to export. What Merlin does store is conversation threads, uploaded documents (PDF, PPT, Word), and image-generation outputs in user-scoped browser storage with no public API. We guide customers through the manual dashboard export, parse uploaded documents for any embedded business entities (person names, company names, deal references), create matching Nutshell records via the REST API, and attach the original document files to the correct Contact, Company, or Activity. We do not migrate workflows or automations because Merlin has no automation model to inventory. Nutshell workflows and any existing automations are scoped separately by the customer's admin post-import.
Every standard and custom field arrives verified.
AI proposes the map; you confirm before any record moves.
Parent–child, lookups, and ownership stay linked.
Calls, emails, meetings — with original timestamps.
Documents, uploads, and inline notes move with the record.
Why teams make this switch
Leaving
What's pushing teams away
Choosing
What's pulling them in
Object mapping
Each row shows how a Merlin object lands in Nutshell, including any object-level transformations, lookup resolution, or schema-design dependencies.
Typical mapping — final map is confirmed during the sample migration step.
Merlin
Uploaded Documents (PDF, PPT, Word)
Nutshell
Attachment (linked to Company, Person, or Opportunity)
1:1We capture Merlin Document Chat uploads as binary file blobs and re-attach them in Nutshell via the API. Free-tier uploads capped at 10 pages are flagged during scoping; Pro-tier unlimited-length uploads migrate in full. Each file is linked to the relevant Nutshell record (Company, Person, or Opportunity) using ContentDocumentLink. If the customer cannot identify the intended record from document naming or content, the attachment is held in a reconciliation queue pending admin direction.
Merlin
Conversation Threads
Nutshell
Note (linked to Person or Company)
1:manyMerlin conversation text exports as structured thread output. We parse each thread for business context—if a thread references a person or company name that maps to a Nutshell record, the thread text becomes a Note linked to that record. Threads without identifiable business context are attached to the originating user record as a general Notes entry. Thread-level model attribution (which AI model responded per turn) is not exported from Merlin and cannot be preserved.
Merlin
User Account (email, plan tier, usage quota)
Nutshell
User
1:1Merlin account metadata (email address, plan tier, Pro status) maps to Nutshell User records. Owner assignment in Merlin is not a first-class concept, so the customer designates which Merlin users map to which Nutshell User during scoping. If a Merlin user has no corresponding Nutshell seat, their documents and conversations are imported under a designated migration admin account and reassigned post-migration.
Merlin
Extracted Person Names (from document parsing)
Nutshell
Person (Contact)
many:1This is a derived object: Merlin does not store Contacts, but uploaded documents may contain person names, email addresses, or titles. We perform entity extraction as a supplementary step, identify unique persons, and create Nutshell Person records. Multiple mentions of the same person across documents merge into a single Contact with the most complete name, email, and phone set retained. The customer reviews and approves the extracted person list before creation.
Merlin
Extracted Company Names (from document parsing)
Nutshell
Company
many:1Like person extraction, Merlin documents may reference company names, domains, or organizations. We extract unique company names, create Nutshell Company records, and link any extracted Persons to their employer Company via the Person-Company relationship. Companies mentioned without any identified Persons are created as standalone Company records for the customer to populate.
Merlin
Image Generation Outputs
Nutshell
Attachment (linked to related record or User)
1:1Merlin image-generation outputs (PNG/JPG) are stored as file attachments in Merlin's user storage. We preserve file type, creation date, and binary content and attach to the relevant Nutshell record if identifiable, or to the importing User record if not. Image context is inferred from conversation thread content when available.
Merlin
Custom Properties
Nutshell
Not applicable
1:1Merlin does not expose a schema for user-defined properties. Any structured metadata stored within Merlin beyond conversation text and file blobs is not accessible for export. We cannot migrate custom fields because none exist in Merlin's data model.
Merlin
Tags
Nutshell
Not applicable
1:1Merlin has no documented tagging or labeling system accessible via export. Tags as a structured metadata concept do not exist in Merlin and therefore have no migration target in Nutshell.
| Merlin | Nutshell | Compatibility | |
|---|---|---|---|
| Uploaded Documents (PDF, PPT, Word) | Attachment (linked to Company, Person, or Opportunity)1:1 | Fully supported | |
| Conversation Threads | Note (linked to Person or Company)1:many | Fully supported | |
| User Account (email, plan tier, usage quota) | User1:1 | Fully supported | |
| Extracted Person Names (from document parsing) | Person (Contact)many:1 | Fully supported | |
| Extracted Company Names (from document parsing) | Companymany:1 | Fully supported | |
| Image Generation Outputs | Attachment (linked to related record or User)1:1 | Fully supported | |
| Custom Properties | Not applicable1:1 | Not supported | |
| Tags | Not applicable1:1 | Not supported |
Gotchas + challenges
Platform-specific issues from each side, plus the pair-specific challenges that don't show up on either platform's page on its own.
Merlin gotchas
No public API for automated export
Document upload limit differences by tier are migration-critical
Conversation metadata is not exported
No contacts or CRM objects means context must be rebuilt
Nutshell gotchas
Contact tier limits enforced on import
No bulk API endpoint requires paginated extraction
Email sequences not exportable via API
Foundation plan disables key sales features
Pair-specific challenges
Migration approach
Manual export guidance and scoping session
We guide the customer through Merlin's dashboard export process to download conversation history and document files. We also provide instructions for capturing browser local storage if the dashboard export does not include full document content. During scoping, we audit the export volume (number of conversations, document count, file sizes), identify which documents were uploaded under Free tier (subject to the 10-page cap), and determine whether entity extraction is in scope. We deliver a written migration scope document before any parsing begins.
Document parsing and entity extraction
We parse all exported documents (PDF, PPT, Word) using structured text extraction. For each document, we identify and extract person names, company names, email addresses, phone numbers, and any deal or project references. Extracted entities are deduplicated and grouped. We deliver a proposed entity list to the customer for review and approval. Any entities the customer marks as non-business (e.g., names appearing in legal boilerplate) are excluded from Nutshell record creation.
Nutshell schema preparation
We review the customer's Nutshell account to confirm which tiers and objects are active (Leads enabled vs. Contacts only, Products catalog, custom fields). We identify any required Nutshell configuration—such as enabling Leads if the customer wants a distinction between unqualified prospects and qualified contacts—before record creation. We do not modify Nutshell's pipeline stages, custom fields, or workflow rules as part of the standard migration scope; these are pre-migration setup tasks for the customer's Nutshell admin.
Entity creation and document attachment via Nutshell API
We create Nutshell Company records first (parent objects), then Person records linked to their Company via the Person-Company relationship, then any relevant Opportunity records if deal context was extractable from documents. All exported files are attached as Nutshell Attachments linked to the appropriate Company, Person, or Opportunity via ContentDocumentLink. Conversation threads that reference identifiable business entities become Notes attached to the relevant record. We resolve the importing User account for all records and flag any owner assignment that requires admin decision.
Validation, reconciliation, and cutover handoff
We generate a row-count reconciliation report showing entities extracted, entities approved, Nutshell records created, and documents attached. The customer spot-checks 20-30 records against the original Merlin export to confirm accuracy. Any mapping errors are corrected before the final delta pass. We deliver a written inventory of conversation threads that could not be linked to a specific record (with file location) for the customer to route manually. Nutshell becomes the system of record upon customer sign-off, and the Merlin account is scheduled for closure.
Platform deep dives
Merlin
Source
Strengths
Weaknesses
Nutshell
Destination
Strengths
Weaknesses
Complexity grading
Standard CRM migration. 1 of 8 objects need a manual workaround.
Overall complexity
Standard migration
Derived from compatibility, mapping clarity, API constraints, and data volume across Merlin and Nutshell.
Object compatibility
1 of 8 objects need a manual workaround.
Field mapping clarity
Field mapping is derived from defaults — final spec confirmed during the sample migration.
Timeline complexity
8-object category — typical timelines run 2–7 days end-to-end.
API constraints
Merlin: Not publicly documented.
Data volume sensitivity
Merlin doesn't expose a bulk API — REST + parallelization used for high-volume runs.
Estimator
Rule-based pricing — no per-record fees, no manual quotes. Migrations over 2M records are scoped individually.
Step 1
Pick a category, then your source and destination platforms.
Category
FAQ
Answers to the questions buyers ask most during Merlin to Nutshell migration scoping. Not seeing yours? Book a call.
Walk through your Merlin to Nutshell migration with a real engineer — 30 minutes, free, written quote within 24 hours.
Book a free 30 minute consultationAdjacent paths
Other ways to leave Merlin
Other ways to arrive at Nutshell
Ready when you are
Tell us record counts and timeline. We'll come back with a written quote inside 1 business day — no commitment, no sales pitch.