CRM migration
Field-level mapping, validation, and rollback between Basic Online CRM and Nutshell. We move data and schema; workflows are rebuilt natively in Nutshell.
Basic Online CRM
Source
Nutshell
Destination
Compatibility
6 of 8
objects map 1:1 between Basic Online CRM and Nutshell.
Complexity
CModerate
Timeline
1-2 weeks
Overview
Moving from Basic Online CRM to Nutshell is a structural step-up for small teams that have outgrown a minimal contact-and-deal tracker. Basic Online CRM stores Deals linked to Contacts by opaque internal numeric IDs, a model that requires cross-referencing during any migration. Nutshell uses name-based associations between People and Organizations and adds native support for Activities, a full pipeline management interface, and unlimited contact storage on all paid plans. We extract via bulk CSV, split large exports that exceed Basic Online CRM's ~5,000-row truncation limit, resolve Deal-Contact IDs against the contact list, standardise untyped custom fields, and write into Nutshell in dependency order. Workflows, automation rules, and any attachment references do not migrate; we flag them in the pre-migration inventory.
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 Basic Online CRM 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.
Basic Online CRM
Contact
Nutshell
Person
1:1Basic Online CRM Contact records map to Nutshell Person. We map name, email, phone, and address fields 1:1. Custom field values stored as raw strings in Basic Online CRM migrate to Nutshell custom fields, but the customer validates intended data types before Nutshell schema creation because Basic Online CRM does not preserve field type metadata on export.
Basic Online CRM
Company
Nutshell
Organization
1:1Basic Online CRM Company records map to Nutshell Organization by name. Basic Online CRM stores a flat list without subsidiaries or hierarchies, so we import each Company as a top-level Organization. We flag duplicate Organisation names appearing multiple times in the source for customer deduplication before final import.
Basic Online CRM
Deal
Nutshell
Task
1:1Basic Online CRM Deals map to Nutshell Task records. The Deal title becomes the Task name, deal value becomes the monetary field, and deal stage becomes the Task status or pipeline stage in Nutshell. The primary challenge is resolving the Basic Online CRM internal numeric Contact ID referenced on each Deal against the contact name list to recreate the Person link in Nutshell.
Basic Online CRM
Deal-Contact association
Nutshell
Task-Person link
1:1Basic Online CRM stores Deal-Contact associations by internal numeric ID rather than name or email. We run a dual export, cross-reference each Deal's contact_id against the contact list during the mapping phase, and recreate the association in Nutshell by matching the Person name. Any Deal that references a deleted Contact (no match in the contact list) is flagged as an orphaned Deal for customer resolution before write-back.
Basic Online CRM
Note
Nutshell
Activity (Note)
1:1Basic Online CRM Notes are free-text and untyped with no native timestamp enforcement. We migrate them as Nutshell Activity entries of type Note. Any timestamps embedded in the note body are not extracted as structured activity dates unless they were explicitly set as a custom field date in Basic Online CRM.
Basic Online CRM
Custom Field
Nutshell
Custom Field
lossyBasic Online CRM custom fields are stored as raw string key-value pairs with no type metadata preserved on export. We migrate them as-is to Nutshell custom fields but ask the customer to validate and confirm intended data types (text, date, number, picklist) before Nutshell schema creation. Date fields in particular may arrive with inconsistent formats across exports.
Basic Online CRM
Owner
Nutshell
User
lossyBasic Online CRM does not surface record-level owner assignment in its CSV exports. We ask the customer upfront which team member should own migrated records in Nutshell and apply bulk owner assignment during write-back. If multiple Basic Online CRM users exist, the customer identifies the owning User per record or provides a mapping table during scoping.
Basic Online CRM
Attachment reference
Nutshell
No migration
1:1Basic Online CRM does not host or store file attachments natively. Any document URLs or file references embedded in Notes or Deal descriptions are not migrated. We include a pre-migration checklist item asking the customer to inventory any such files for manual re-upload after migration.
| Basic Online CRM | Nutshell | Compatibility | |
|---|---|---|---|
| Contact | Person1:1 | Fully supported | |
| Company | Organization1:1 | Fully supported | |
| Deal | Task1:1 | Fully supported | |
| Deal-Contact association | Task-Person link1:1 | Fully supported | |
| Note | Activity (Note)1:1 | Fully supported | |
| Custom Field | Custom Fieldlossy | Fully supported | |
| Owner | Userlossy | Fully supported | |
| Attachment reference | No migration1:1 | Fully 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.
Basic Online CRM gotchas
CSV export silently truncates large contact lists
Deal-Contact associations are stored by internal ID only
Custom field data types are not preserved on export
No native attachment storage means files are not migrated
User/owner structure is not explicit in exported data
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
Discovery and export assessment
We audit the Basic Online CRM instance for record counts across Contacts, Companies, Deals, Notes, and custom fields. We confirm the customer's tier (Free, Starter, Professional, or Enterprise) to determine export method: CSV for Free through Professional, and documented API for Enterprise. If record counts exceed 5,000 in any object, we flag the need for multi-file export assembly. We also confirm the number of distinct Basic Online CRM users and ask the customer which Nutshell User should own migrated records.
Dual export and association resolution
We run a dual export of Contacts and Deals simultaneously to ensure the association resolution uses a consistent snapshot. We extract the contact_id column from Deals and cross-reference it against the contact list to resolve each numeric ID to a Person name. Any Deal with an unresolved contact_id is flagged as orphaned and held in a reconciliation queue for the customer to resolve before import. We also extract and normalise all custom field values, noting any date-format inconsistencies for customer review.
Data quality review and field mapping confirmation
We present the customer with a pre-import data quality report covering duplicate Contacts, duplicate Organizations, orphaned Deals, and custom field format inconsistencies. The customer reviews and confirms the field mapping between Basic Online CRM custom fields and Nutshell custom field types before we create the Nutshell schema. This step prevents misformatted values from landing in typed Nutshell fields.
Schema creation and owner assignment
We create the Nutshell custom fields confirmed during mapping, set the bulk owner assignment for migrated records, and configure any pipeline stages that match the source Deal stages. If the customer uses Basic Online CRM's basic pipeline board, we replicate the stage names and order in Nutshell's pipeline configuration. Owner assignment is applied as a bulk setting unless the customer provided a per-record mapping table during scoping.
Staged import in dependency order
We write data into Nutshell in record-dependency order: Organizations first (from Companies), then People (from Contacts) with Organisation links resolved, then Tasks (from Deals) with Person links resolved, then Activities (from Notes). Each phase emits a row-count reconciliation report. If any phase produces orphaned records, import pauses and the customer resolves the flagged records before we resume.
Cutover, validation, and attachment handoff
We freeze writes in Basic Online CRM during cutover, run a final delta migration of any records modified during the migration window, then enable Nutshell as the system of record. We deliver the attachment inventory to the customer for manual re-upload and provide a written summary of any orphaned Deals that require manual reassignment in Nutshell. We do not rebuild Basic Online CRM workflow automation in Nutshell because Basic Online CRM has no workflow engine on Free or Starter tiers, and we do not offer post-migration admin rebuild as standard scope.
Platform deep dives
Basic Online CRM
Source
Strengths
Weaknesses
Nutshell
Destination
Strengths
Weaknesses
Complexity grading
Moderate CRM migration. 4 of 8 objects need a mapping; the rest are 1:1.
Overall complexity
Moderate migration
Derived from compatibility, mapping clarity, API constraints, and data volume across Basic Online CRM and Nutshell.
Object compatibility
4 of 8 objects need a mapping; the rest are 1:1.
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
Basic Online CRM: Not publicly documented.
Data volume sensitivity
Basic Online CRM 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 Basic Online CRM to Nutshell migration scoping. Not seeing yours? Book a call.
Walk through your Basic Online CRM 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 Basic Online CRM
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.