CRM migration
Field-level mapping, validation, and rollback between Clientjoy and Nutshell. We move data and schema; workflows are rebuilt natively in Nutshell.
Clientjoy
Source
Nutshell
Destination
Compatibility
3 of 8
objects map 1:1 between Clientjoy and Nutshell.
Complexity
BStandard
Timeline
2-3 weeks
Overview
Moving from Clientjoy to Nutshell is a migration for small agencies and consultants who need a stable CRM without the bundle overhead of proposals, e-signing, and invoicing that Clientjoy includes. Clientjoy organizes its data around a linear prospect-to-payment lifecycle: Leads flow into Customers, tied to Pipelines, Proposals, and Invoices. Nutshell uses a Leads-People-Companies model with a separate Accounts concept and no native invoice or quote object. We resolve the Lead-to-People split, map Clientjoy pipeline stages to Nutshell's single default pipeline (with multi-pipeline available on Pro and above), and handle the fact that Clientjoy's API is gated to the Agency plan, meaning Starter plan users require CSV exports and manual field-mapping. We do not migrate Clientjoy's document builder templates, e-sign audit trails, email sequences, client portal configurations, or automation rules as code — these require rebuilding in Nutshell or accepting a written inventory as the handoff artifact. Recurring invoice schedules from Clientjoy are preserved as metadata and noted for Nutshell admin reconstruction using a third-party quoting or billing integration.
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 Clientjoy 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.
Clientjoy
Lead
Nutshell
Lead
1:1Clientjoy Leads map directly to Nutshell Leads. The Lead's name, email, phone, source, status, and assigned pipeline stage migrate as standard Nutshell Lead fields. Any custom fields defined on the Lead object in Clientjoy (gated to Agency plan on source) map to Nutshell Lead custom fields, which we pre-create using the same field label and type (text, date, currency, dropdown). Clientjoy pipeline stage assignments become Nutshell Lead status values. Owner assignment migrates by email match against Nutshell Users.
Clientjoy
Customer
Nutshell
Person or Company
1:manyClientjoy Customers represent the converted state of a prospect. We split Clientjoy Customers into two migration targets: the person-level data (contact name, email, phone, address) maps to Nutshell Person, and any company-level data (company name, industry, size) maps to Nutshell Company. If Clientjoy stored a company name on the Customer record but no separate Company record existed, we create a Nutshell Company first, then link the Person to it via the accountId reference. Tags on the Clientjoy Customer migrate as plain-text tags on the Nutshell Person.
Clientjoy
Pipeline
Nutshell
Pipeline
lossyClientjoy pipeline definitions and custom stage names are exported via API (Agency plan) or extracted from CSV exports. Each Clientjoy pipeline becomes a Nutshell Pipeline with stages mapped to Nutshell stage names. Nutshell Foundation and Growth support one pipeline; Nutshell Pro supports up to 5 pipelines; Nutshell Business and Enterprise support unlimited. We configure pipelines before data import and map Clientjoy stage probability percentages to Nutshell stage probabilities.
Clientjoy
Invoice
Nutshell
Note (metadata)
lossyClientjoy Invoices (one-time and recurring) have no direct Nutshell equivalent, as Nutshell does not include a native invoice object. We export invoice headers, line items, tax rates, payment status, currency, and recurring schedule as a structured JSON metadata record. This metadata is attached as a Note on the related Nutshell Person or Company record. The customer should plan to use a third-party billing integration (QuickBooks, Wave, Zoho Invoice) post-migration for invoice generation, or evaluate Nutshell's Quoting tool on Sales Growth and above as a proposal-to-quote replacement.
Clientjoy
Document and Template
Nutshell
File (content)
1:1Document templates use merge fields tied to Lead, Customer, and Invoice objects in Clientjoy. We extract the raw document content as HTML or plain text and the template field associations as a JSON mapping table. Formatted document content migrates as Nutshell Files attached to the related Person or Company. We do not preserve Clientjoy's document builder layout or e-sign audit trails, which are platform-specific. Signed PDFs should be downloaded from Clientjoy before migration cutover if legal documentation retention is required.
Clientjoy
Custom Field
Nutshell
Custom Field
1:1Custom fields on Clientjoy Leads and Customers (available on Agency plan and above) map to Nutshell custom fields on Lead, Person, and Company respectively. We pre-create the destination custom fields in Nutshell before data import, matching field types (text, long text, currency, date, dropdown). Starter plan users on Clientjoy who created no custom fields have no source custom field definitions to migrate. Any custom field values present on a Starter plan account should be treated as plain fields migrated under the standard field mapping.
Clientjoy
Email Sequence
Nutshell
Note (inventory)
lossyClientjoy Email Sequences are automation objects tied to specific trigger conditions and cadence steps. We export sequence name, step count, timing rules, and trigger configuration as a JSON inventory document. We do not migrate sequences as functional code into Nutshell because Nutshell's Sales Pro and above support personal email sequences with a different data model. The inventory document serves as the handoff artifact for the customer's admin to configure equivalent sequences in Nutshell or a dedicated sales engagement tool post-migration.
Clientjoy
Client Portal
Nutshell
Note (configuration)
lossyClientjoy Client Portal configurations including white-label settings, custom domain, CSS styling, and portal widget embeddings are exportable as configuration data. Portal content and uploaded files are exported separately. Nutshell does not include a client portal feature, so portal configuration migrates as a written inventory noting each setting, URL, and CSS block for manual reconfiguration in a third-party portal tool (Client Portal, HubSpot CMS, or a custom build) post-migration.
| Clientjoy | Nutshell | Compatibility | |
|---|---|---|---|
| Lead | Lead1:1 | Fully supported | |
| Customer | Person or Company1:many | Fully supported | |
| Pipeline | Pipelinelossy | Fully supported | |
| Invoice | Note (metadata)lossy | Fully supported | |
| Document and Template | File (content)1:1 | Fully supported | |
| Custom Field | Custom Field1:1 | Fully supported | |
| Email Sequence | Note (inventory)lossy | Fully supported | |
| Client Portal | Note (configuration)lossy | 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.
Clientjoy gotchas
API access requires Agency plan or higher
Document builder reliability is poor
Post-Synup support degradation affects data hygiene
Custom fields require Agency plan
E-sign audit trails are platform-specific
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 plan tier verification
We audit the source Clientjoy account for plan tier (Starter, Agency, Enterprise), active records by type (Leads, Customers, Pipelines, Invoices, Documents, Sequences), custom field definitions, and API access availability. If the account is on the Starter plan, we confirm CSV export coverage and identify any API-gated data gaps. We also assess data hygiene by running a duplicate scan, incomplete-field scan, and stale-record scan to surface cleanup items before migration begins.
Field mapping design and Nutshell schema preparation
We design the destination schema in Nutshell before any data moves. This includes creating custom fields on Lead, Person, and Company to match Clientjoy custom field definitions, configuring pipeline stages with probability percentages aligned to the source pipeline, and mapping Clientjoy Customer records to the Nutshell Person-and-Company split. If multiple Clientjoy pipelines exist, we determine whether Nutshell's plan tier supports multiple pipelines (Pro and above) and configure accordingly.
Data extraction via API or CSV
For Agency and Enterprise plan accounts, we extract records via the Clientjoy REST API with rate-limit handling and exponential backoff. For Starter plan accounts, we use CSV exports and supplement with manual data pulls for any objects not covered by the export. We extract Leads, Customers, pipeline stage assignments, custom field values, and invoice metadata (headers, line items, recurring schedules) in structured JSON format. Document content is exported as HTML or plain text with template merge-field associations preserved as a separate JSON mapping.
Sandbox migration and reconciliation
We run a full migration into a Nutshell trial or sandbox environment using production-like data volume. The customer's admin reviews migrated records against the source, spot-checks field-level accuracy, and validates that pipeline stage assignments and custom field values are intact. Any mapping corrections are made before production migration begins. This step also validates that the Person-and-Company split for Customer records is functioning as expected.
Production migration in dependency order
We run production migration in record-dependency order: Companies first (as the parent entity for person records), then Persons (with accountId resolved), then Leads (with owner resolved by email match), then pipeline stage assignments, then invoice metadata as Notes, then document content as Files. Custom fields are set during the record insert phase, not as a separate update pass. Any Clientjoy Owner without a matching Nutshell User goes to a reconciliation queue for manual provisioning before record import resumes.
Cutover, validation, and automation rebuild handoff
We freeze writes in Clientjoy during cutover, run a final delta migration of any records modified during the migration window, and enable Nutshell as the system of record. We deliver a written inventory of Clientjoy email sequences, workflow configurations, and client portal settings for the customer's admin to rebuild in Nutshell or a third-party tool. We support a five-business-day post-cutover window to resolve any reconciliation issues raised by the team.
Platform deep dives
Clientjoy
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 Clientjoy 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
Clientjoy: Not publicly documented on the Stoplight portal. We assume typical SaaS tenant limits and pace requests against the customer's plan during scoping..
Data volume sensitivity
Clientjoy 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 Clientjoy to Nutshell migration scoping. Not seeing yours? Book a call.
Walk through your Clientjoy 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 Clientjoy
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.