CRM migration
Field-level mapping, validation, and rollback between TeamWave and Nutshell. We move data and schema; workflows are rebuilt natively in Nutshell.
TeamWave
Source
Nutshell
Destination
Compatibility
5 of 8
objects map 1:1 between TeamWave and Nutshell.
Complexity
BStandard
Timeline
2-3 weeks
Overview
Moving from TeamWave to Nutshell is a platform reduction from an integrated CRM-Project-HR suite to a focused sales CRM. TeamWave stores CRM data across Contacts, Companies, Deals, Projects, Tasks, Users, and HR records with interrelated foreign keys; Nutshell uses People, Companies, Deals, Leads, Activities, and custom fields on People and Companies. Since TeamWave publishes no public API reference, all extraction relies on CSV exports from the web UI, and we reconstruct record relationships by cross-referencing IDs embedded in the export. Projects and Tasks have no direct Nutshell object, so we map them to custom fields on the linked Company or Deal, flagging this scope for manual validation in Nutshell's admin settings. HR records map to People with a department Role custom field. Attachments do not migrate; we snapshot metadata and hand off a re-upload manifest. Workflows, automations, and project management task dependencies do not migrate as code.
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 TeamWave 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.
TeamWave
Contact
Nutshell
Person
1:1TeamWave Contacts map directly to Nutshell People. We extract the full contact record including name, email, phone, address, and lifecycle stage, then map these to the standard Person fields in Nutshell. Any custom fields on the TeamWave Contact migrate to Nutshell custom fields on People. The company_id foreign key is retained so that each Person can be linked to its corresponding Nutshell Company after the Company import phase completes.
TeamWave
Company
Nutshell
Company
1:1TeamWave Company records map 1:1 to Nutshell Companies. The company domain and address fields map directly. Company records are imported before People so that the Company lookup relationship is satisfied at the moment of Person insert.
TeamWave
Deal
Nutshell
Deal
1:1TeamWave Deals map to Nutshell Deals with stage, value, owner, and expected close date preserved. The dealstage property maps to the Nutshell pipeline stage, and owner assignment resolves by email match against the Nutshell User table. Note that Nutshell does not support custom fields on Deals, so any custom properties on a TeamWave Deal must be mapped to custom fields on the linked Company or Person, which we flag during scoping.
TeamWave
Project
Nutshell
Custom fields on Company or Person
lossyTeamWave Projects have no direct Nutshell equivalent. We map Project name and client association to a custom text field on the linked Company, and project status, start date, and end date to custom date and picklist fields on the same Company record. Customers with multiple Projects per Company store them as newline-delimited or JSON-structured custom field values. This is a known limitation of the mapping; we document the full Project list in the migration manifest for the customer's admin to restructure if needed.
TeamWave
Task
Nutshell
Activity (Task)
lossyTeamWave Tasks linked to Projects or Contacts map to Nutshell Activities. We preserve the task subject, status, priority, assignee, due date, and the project_id reference as a custom text field on the Activity for traceability. Task hierarchy and parent-child relationships from TeamWave are flattened into individual Activity records; we document the original hierarchy in the migration manifest.
TeamWave
User / Team Member
Nutshell
User
1:1TeamWave Users map to Nutshell Users by email match. Any HubSpot Owner references on Deals and Activities resolve to the corresponding Nutshell User after the User mapping phase. Users without a matching Nutshell account go to a reconciliation queue for the customer's admin to provision before record import resumes.
TeamWave
Calendar Events
Nutshell
Activity (Task)
1:1TeamWave Calendar records carrying event title, date/time, linked entity, and attendees migrate to Nutshell Activity records with the event date preserved as ActivityDate. Linked entity resolves to the appropriate Person or Deal lookup in Nutshell.
TeamWave
HR Records / Employees
Nutshell
Person with custom fields
lossyTeamWave HR records (name, role, department, basic metadata) map to Nutshell People records with a Role custom field and Department custom field. Since Nutshell has no native HR module, employee records coexist with customer People records; we use a Person type custom field to distinguish employee from customer records during import.
| TeamWave | Nutshell | Compatibility | |
|---|---|---|---|
| Contact | Person1:1 | Fully supported | |
| Company | Company1:1 | Fully supported | |
| Deal | Deal1:1 | Fully supported | |
| Project | Custom fields on Company or Personlossy | Fully supported | |
| Task | Activity (Task)lossy | Fully supported | |
| User / Team Member | User1:1 | Fully supported | |
| Calendar Events | Activity (Task)1:1 | Mapping required | |
| HR Records / Employees | Person with custom fieldslossy | Mapping required |
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.
TeamWave gotchas
No publicly documented API endpoint surface
Attachment export requires manual re-upload
Free tier enforces feature caps that affect migration scope
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
Scoping and export preparation
We audit the TeamWave account for record counts across Contacts, Companies, Deals, Projects, Tasks, Users, and HR records. We check the current plan tier and advise upgrading to Pro temporarily if the customer is on the Basic free tier to remove export caps. We outline the full object list, flag every TeamWave custom field, and document the Project-to-Company and Task-to-Activity mapping strategy. The output is a written scope document with a per-object record count estimate.
CSV extraction from TeamWave
We extract data from TeamWave via the web UI in CSV format. For large datasets, we script repeated batch exports and merge results by cross-referencing ID columns and the company_id foreign key. We verify row counts per object against the scoping estimate and flag any missing relationships before proceeding. The merged CSVs become the migration source of truth.
Nutshell custom field creation
We provide the customer with a custom field manifest listing every TeamWave custom field, its source data type, and the recommended Nutshell field type and target object (Person or Company). The customer's Nutshell admin creates these fields in Nutshell settings before import begins. We include step-by-step instructions and screenshots from Nutshell's custom field documentation. This step requires no FlitStack AI involvement beyond delivering the manifest.
Staging migration and reconciliation
We run a test migration into the customer's Nutshell staging environment using a subset of data. We verify record counts (People in, Companies in, Deals in, Activities in), spot-check ten to fifteen records per object against the TeamWave source CSVs, and confirm that custom field values populated correctly. Any mapping corrections are applied before the production migration begins.
Production migration in dependency order
We run production migration in record-dependency order: Nutshell Users (validated), Companies (from TeamWave Companies), People (with Company lookup resolved), Deals (with owner resolved by email match), Activities (Tasks and Events from TeamWave Calendar and Tasks), and HR records (as People with Role and Department custom fields). Projects are written to custom fields on the linked Company record. Each phase emits a row-count reconciliation report before the next phase begins. We use Nutshell's REST API for all writes with rate-limit handling and retry logic.
Attachment manifest delivery and cutover
We deliver the attachment metadata manifest with original filenames, sizes, linked object types, and destination record IDs so the customer's admin can re-upload files in Nutshell. We freeze TeamWave writes during cutover, run a final delta check for any records modified during the migration window, then hand off Nutshell as the system of record. We provide a one-week hypercare window for reconciliation issues. Workflows, project automations, and HR module logic do not migrate and are documented separately for admin review.
Platform deep dives
TeamWave
Source
Strengths
Weaknesses
Nutshell
Destination
Strengths
Weaknesses
Complexity grading
Standard CRM migration. 2 of 8 objects need a mapping; the rest are 1:1.
Overall complexity
Standard migration
Derived from compatibility, mapping clarity, API constraints, and data volume across TeamWave and Nutshell.
Object compatibility
2 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
TeamWave: Not publicly documented.
Data volume sensitivity
TeamWave 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 TeamWave to Nutshell migration scoping. Not seeing yours? Book a call.
Walk through your TeamWave 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 TeamWave
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.