CRM migration
Field-level mapping, validation, and rollback between Payaca and Nutshell. We move data and schema; workflows are rebuilt natively in Nutshell.
Payaca
Source
Nutshell
Destination
Compatibility
4 of 8
objects map 1:1 between Payaca and Nutshell.
Complexity
BStandard
Timeline
3-5 weeks
Overview
Moving from Payaca to Nutshell is a structural migration that trades vertical-specific job management for a broader, lower-cost general CRM. Payaca structures its entire data model around the clean tech install lifecycle—Lead through Complete stages, linked Projects, and compliance custom fields for AHJ requirements. Nutshell does not have a Jobs or Projects object; we remap Payaca Projects to Nutshell Deals, preserving the project identifier and stage history, and map custom compliance fields to Nutshell's available field types. We migrate Customers (People and Companies in Nutshell), Invoices as line items on Deals, Items as Products, and Service Reminders as Tasks. We do not migrate Payaca's templated automations as code; we deliver a written inventory of triggers and conditions for your Nutshell admin to rebuild. The Growth-tier flat-rate pricing ($1,724/month) often exceeds Nutshell's per-user cost for teams above four seats, which is the primary cost driver behind this migration.
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 Payaca 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.
Payaca
Customer
Nutshell
Person + Company
1:manyPayaca Customers map to Nutshell Person records (individual contacts) linked to Company records (the household or business). The Payaca customer address and contact fields split into Person fields (name, email, phone, personal address) and Company fields (company name, website, billing address). The Payaca customer ID is preserved in a custom field for cross-reference during reconciliation.
Payaca
Project
Nutshell
Deal
1:1Payaca Projects map to Nutshell Deals as the closest structural equivalent. The Payaca project stage (Lead, Survey, Quote, Install, Complete) maps to Nutshell Deal stages, which we configure to match Payaca's lifecycle names before migration. The Payaca project identifier is stored in a custom field on the Nutshell Deal. Projects linked to a Customer carry the Person as the Deal's primary contact.
Payaca
Pipeline
Nutshell
Pipeline
lossyPayaca's fixed pipeline stages (Lead, Survey, Quote, Install, Complete) are recreated as Nutshell Pipeline stages with matching names and reorder logic. We configure the stage sequence in Nutshell during migration setup so that historical project stage transitions map to the correct Nutshell stage positions. Any automation-triggered stage changes in Payaca are documented for manual recreation in Nutshell Workflows.
Payaca
Invoice
Nutshell
Deal Line Item
1:manyPayaca Invoices attached to a Project merge into the corresponding Nutshell Deal as line items. Invoice number, line item description, quantity, unit price, and total amount map to Deal fields. Payment status (paid, partial, overdue) from Payaca is preserved in a custom Deal field since Nutshell Deals do not have native payment status. Stripe transaction references on Payaca Invoices are stored as a custom text field on the Deal for reconciliation.
Payaca
Item
Nutshell
Product
1:1Payaca Items (panel configurations, battery sizes, labor rates) map to Nutshell Products. Product name, description, unit price, and cost carry over directly. We create a Nutshell Product for each unique Payaca Item so that the Item library is available for future quoting in Nutshell.
Payaca
Document
Nutshell
Attachment
1:1Payaca Documents linked to Projects or Customers are migrated as file references (URLs) in Nutshell custom fields rather than binary file migration. Actual document files (PDFs, signed proposals, permits) require separate file transfer and reattachment in Nutshell because Nutshell does not have a native document portal equivalent to Payaca's customer portal. We provide a file inventory spreadsheet listing each document, its associated Payaca project or customer, and recommended upload location in Nutshell.
Payaca
Custom Field (Compliance)
Nutshell
Custom Field
lossyPayaca custom fields for AHJ requirements, permit numbers, inspection dates, and equipment specifications map to Nutshell custom fields on Person (for customer-specific compliance data) and Deal (for project-specific compliance data). Field type conversion is required: Payaca date pickers map to Nutshell date fields; dropdowns map to Nutshell picklists; text fields map to Nutshell text fields with 225-character limit noted. Very long text fields require splitting or truncating to fit Nutshell's Long Text field limit.
Payaca
Service Reminder
Nutshell
Task
1:1Payaca Service Reminders map to Nutshell Tasks with the due date, description, and associated Person or Deal preserved. Recurring reminder patterns from Payaca are documented as a Task recurrence recommendation (daily, weekly, monthly) in the handoff notes since Nutshell Tasks support recurrence rules. The Task is linked to the migrated Person or Deal so that the reminder appears in the correct Nutshell activity timeline.
| Payaca | Nutshell | Compatibility | |
|---|---|---|---|
| Customer | Person + Company1:many | Fully supported | |
| Project | Deal1:1 | Fully supported | |
| Pipeline | Pipelinelossy | Fully supported | |
| Invoice | Deal Line Item1:many | Fully supported | |
| Item | Product1:1 | Fully supported | |
| Document | Attachment1:1 | Fully supported | |
| Custom Field (Compliance) | Custom Fieldlossy | Fully supported | |
| Service Reminder | Task1: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.
Payaca gotchas
CSV export only captures customer contact records
Project imports require pre-existing customer IDs
Automation rule portability is limited to templates
Stripe transaction fees are external to Payaca billing
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 data audit
We audit the Payaca account across record type (Core or Growth tier), customer count, active project count, invoice volume, custom field definitions (field name, type, associated object), automation inventory (active templates and custom rules), and integration list. We extract customer records via CSV and project records via API query. We produce a written migration scope with record counts, custom field mapping, and automation inventory for the customer's review before migration begins.
Nutshell sandbox setup and schema design
We create a Nutshell sandbox or trial account and configure the pipeline stages to match Payaca's lifecycle (Lead, Survey, Quote, Install, Complete). We create custom fields on Person and Deal objects to receive Payaca compliance and permit data. We configure custom picklist values for any dropdown fields. The customer reviews the sandbox configuration and approves the stage names and custom field definitions before any data is written.
Customer and Company migration (first wave)
We run the first migration wave: Payaca Customers become Nutshell People with Company records created for any organization-linked customers. The Payaca customer ID is stored in a custom field for cross-reference. The migration validates that all Person records have at least a name or email before proceeding to the project wave. We reconcile the Person count against the source Payaca customer export count.
Project and Item migration (second wave)
We map Payaca Projects to Nutshell Deals using the Person mapping from Wave 1 to set the Deal's primary contact. Payaca Items migrate to Nutshell Products. We validate that every Deal has a linked Person and that all Payaca project stages map to the correct Nutshell pipeline stage. Any Payaca projects without a matching Customer are held in a reconciliation queue for manual assignment.
Invoice, document reference, and reminder migration (third wave)
We migrate Payaca Invoices as line items on the corresponding Nutshell Deals. Payment status and Stripe references are stored as custom fields on the Deal. Service Reminders become Nutshell Tasks linked to the appropriate Person or Deal. Document references are compiled into a migration inventory spreadsheet that lists each file's Payaca URL, associated project or customer, and recommended Nutshell attachment location for manual re-upload.
Cutover, validation, and automation handoff
We freeze Payaca write access during cutover, run a final delta migration of any records modified during the migration window, then mark Nutshell as the system of record. We deliver the automation inventory document listing each Payaca automation with its trigger, conditions, and recommended Nutshell Workflow equivalent. We provide a one-week hypercare window to resolve record-reconciliation issues reported by the customer's team. We do not rebuild Payaca automations in Nutshell as part of the migration scope; that is a separate workflow rebuild engagement.
Platform deep dives
Payaca
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 Payaca 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
Payaca: Not publicly documented in available help resources.
Data volume sensitivity
Payaca 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 Payaca to Nutshell migration scoping. Not seeing yours? Book a call.
Walk through your Payaca 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 Payaca
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.