CRM migration
Field-level mapping, validation, and rollback between Knock CRM and Nutshell. We move data and schema; workflows are rebuilt natively in Nutshell.
Knock CRM
Source
Nutshell
Destination
Compatibility
11 of 12
objects map 1:1 between Knock CRM and Nutshell.
Complexity
BStandard
Timeline
48–72 hours
Overview
Knock CRM is a purpose-built leasing and property-management CRM that excels at Knock Now scheduling, guest card tracking, and attribution reporting for multifamily operators. As teams expand into broader B2B sales cycles or need deeper pipeline customization, Knock's domain-specific model becomes a constraint rather than an advantage. Nutshell is a general-purpose SMB CRM built around Accounts, Contacts, Leads, and Opportunities, with a single customizable pipeline and integrated email/calendar sync that supports a wider range of sales motions. The migration carries all standard records — People, Companies, Deals, Activities, Notes, Attachments, and custom properties — into Nutshell's equivalent objects. Knock-specific constructs like guest cards, lease terms, and unit-level data have no direct Nutshell equivalent; FlitStack surfaces these as custom fields on the Account record or preserves them as reference data. Knock's automations, Knockbot chatbot, and property-specific workflows do not migrate — FlitStack exports them as rebuild reference documentation. The migration uses Nutshell's API with scoped read access from Knock, a delta-pickup window capturing in-flight changes during cutover, and a one-click rollback if reconciliation fails.
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 Knock 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.
Knock CRM
People
Nutshell
Contact
1:1Knock People map directly to Nutshell Contacts. All standard fields (name, email, phone, address) transfer 1:1. Each Knock Person must be linked to a Nutshell Account — FlitStack creates the Account first from the Knock Company, then links the Contact. Knock's guest card records (if stored as People) require a separate custom field mapping since Nutshell has no guest card object.
Knock CRM
People
Nutshell
Lead
1:manyIf Knock People records include unqualified prospects (not yet tied to a company or lease), they route to Nutshell Leads rather than Contacts. FlitStack splits by a Knock status field (e.g., 'Prospect' vs. 'Lease Signed') or by whether a Company association exists. Teams without a clear qualification status in Knock should decide which records go to Lead vs. Contact before migration runs.
Knock CRM
Company
Nutshell
Account
1:1Knock Company records map to Nutshell Accounts. The Account name, website, industry, employee count, and address fields transfer directly. Knock's parent/child company hierarchies map to Nutshell's Account Hierarchy via the Parent Account field. Multi-company associations on a single Knock Person collapse to one primary Account–Contact link in Nutshell.
Knock CRM
Deal
Nutshell
Opportunity
1:1Knock Deals map to Nutshell Opportunities. The deal name, amount, stage, close date, and owner transfer directly. Knock's deal-stage labels are mapped to Nutshell's pipeline stage values during migration — FlitStack generates the value-mapping table in the planning phase. Open and closed-won deals migrate with their original stage timestamps preserved as Nutshell custom fields.
Knock CRM
Pipeline
Nutshell
Nutshell Pipeline
1:1Knock's multiple independent pipelines must map to Nutshell's single pipeline. Teams have two options: select one Knock pipeline as primary and drop the others, or consolidate all stages into one Nutshell pipeline. FlitStack delivers a pipeline consolidation plan as part of the pre-migration spec so Nutshell admins can pre-create the correct stage values before data lands.
Knock CRM
Custom Properties (People)
Nutshell
Custom Fields on Contact
1:1Knock's custom properties on People records (e.g., 'referred_by', 'source_channel', 'apartment_interest') require Nutshell custom fields to be created before migration. Nutshell supports text, date, number, and pick-list custom field types. Multi-select Knock properties are flattened to pipe-delimited text in Nutshell. FlitStack lists every Knock custom property in the planning spec so Nutshell admins can pre-create fields.
Knock CRM
Custom Properties (Company)
Nutshell
Custom Fields on Account
1:1Knock Company custom properties (e.g., 'property_type', 'unit_count', 'market_class') migrate to Nutshell Account custom fields. The same type-restriction note applies: Nutshell's pick-list fields are less flexible than Knock's. Teams should identify which Knock custom properties are business-critical vs. reference-only and prioritize creating Nutshell custom fields only for the former.
Knock CRM
Activity Log (calls, emails, meetings)
Nutshell
Task / Event
1:1Knock's activity history (calls logged, emails sent, meetings scheduled) maps to Nutshell Tasks and Events. Call activities with disposition notes become Tasks with Type='Call'. Email activities become Tasks with Type='Email'. Meetings with start/end times become Nutshell Events. All original timestamps and owner assignments are preserved. FlitStack maps the activity type from Knock's activity.kind field to the corresponding Nutshell object.
Knock CRM
Notes / Attachments
Nutshell
Note / File Attachment
1:1Knock Notes with associated file attachments migrate to Nutshell Notes with linked Files. File size limits apply (Nutshell's default 25MB per file); files exceeding this threshold are flagged for manual re-upload. Rich-text formatting in Knock Notes is preserved as plain text or HTML in Nutshell Notes depending on the target field type available in the account's plan.
Knock CRM
Tags
Nutshell
Tags
1:1Knock's tagging system maps to Nutshell's native Tags. Tag names transfer verbatim. Nutshell applies tags at the record level (Account, Contact, or Opportunity). If Knock tags are used for complex segmentation logic, the team should audit which tag-to-segment mappings need to be rebuilt as Nutshell filters or custom reports.
Knock CRM
Owner / User
Nutshell
Nutshell User
1:1Knock owner IDs are resolved by email match against Nutshell users. FlitStack generates an owner-resolution report showing matched users, unmatched owners, and a fallback assignment rule (unassigned records go to the migration admin or a designated Nutshell user). Knock users who are inactive in Knock but exist in Nutshell are flagged to prevent orphaned records.
Knock CRM
Knockbot / Chatbot Configuration
Nutshell
No Equivalent
1:1Knock's Knockbot chatbot configuration and automated follow-up sequences tied to the chatbot have no Nutshell equivalent. These are exported as JSON configuration files in the FlitStack rebuild package. The Nutshell admin or a consultant can use Nutshell Pro's sales automation features (email sequences, task triggers) to approximate parts of the Knockbot logic manually.
| Knock CRM | Nutshell | Compatibility | |
|---|---|---|---|
| People | Contact1:1 | Fully supported | |
| People | Lead1:many | Fully supported | |
| Company | Account1:1 | Fully supported | |
| Deal | Opportunity1:1 | Fully supported | |
| Pipeline | Nutshell Pipeline1:1 | Fully supported | |
| Custom Properties (People) | Custom Fields on Contact1:1 | Fully supported | |
| Custom Properties (Company) | Custom Fields on Account1:1 | Fully supported | |
| Activity Log (calls, emails, meetings) | Task / Event1:1 | Fully supported | |
| Notes / Attachments | Note / File Attachment1:1 | Fully supported | |
| Tags | Tags1:1 | Mapping required | |
| Owner / User | Nutshell User1:1 | Fully supported | |
| Knockbot / Chatbot Configuration | No Equivalent1: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.
Knock CRM gotchas
Prospect-to-Unit linkage is not a foreign key in all exports
Attribution data is a Prospect property, not a separate object
Pipeline stages are property-specific, not global
Lease records may lack full document blobs in standard export
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
Extract full Knock data export via API
FlitStack initiates a read-only API connection to the Knock CRM account using scoped credentials. The export pulls all standard objects — People, Companies, Deals, Activities (calls, emails, meetings), Notes, and Attachments — along with all custom property values. A data audit report is generated showing record counts per object, custom property names and types, pipeline and stage definitions, owner list, and activity volume. This audit is shared with the team for review before field mapping begins. Knock remains fully operational during this phase — FlitStack only reads data.
Build the mapping specification and plan
FlitStack generates a full mapping specification document covering every field from the Knock export. For each field, the spec names the source Knock field, the target Nutshell field, the mapping type (direct, value-mapping, transformed, or custom_field_required), and any transformation notes. The spec also includes the pipeline consolidation recommendation, owner-resolution report, and a list of Nutshell custom fields that need to be created before migration. The team reviews and approves the spec; FlitStack makes adjustments based on feedback before any data is written to Nutshell.
Create Nutshell custom fields and pipeline stages
Before migration data lands, the Nutshell admin (or FlitStack on the team's behalf) creates the custom fields and pipeline stages identified in the mapping spec. This includes custom fields for Knock custom properties that have no direct Nutshell equivalent (e.g., referral_source, Knock_object_id, lease_terms). The pipeline consolidation is executed in Nutshell — all Knock pipeline stages are mapped into the single Nutshell pipeline, with inactive Knock pipelines either archived or merged. FlitStack provides a step-by-step setup guide with screenshots for each custom field and stage. This step is a prerequisite for the migration run; FlitStack will not write records to Nutshell until the target schema is confirmed ready.
Run a sample migration with field-level verification
A representative sample of 50–100 records (spanning People, Companies, Deals, and Activities) is migrated first. The team reviews the results directly in Nutshell — checking that Knock People landed as Contacts with correct names and email addresses, that Knock Deals appear as Opportunities with the right amounts and stages, that custom property values are visible in the new Nutshell custom fields, and that owner resolution assigned records to the correct Nutshell users. FlitStack generates a sample migration report showing field-by-field pass/fail counts. The team approves the sample before FlitStack commits to the full migration run. Any field mapping corrections are made to the spec at this stage.
Execute full migration with delta-pickup and audit log
The full migration runs in ordered batches — Companies first (to establish Account records), then People (linked to their Accounts), then Deals (linked to Accounts and Contacts), then Activities and Notes last. Nutshell's API rate limits are respected via adaptive batch sizing. Throughout the run, FlitStack writes an audit log covering every record created, updated, or skipped, with reasons for any failures. A delta-pickup window (typically 24 hours) runs concurrently: any records created or modified in Knock during the migration are captured and written to Nutshell before the final cutover. After the delta window closes, FlitStack runs a reconciliation count check against the Knock export totals.
Cut over and validate with rollback available
The team confirms Nutshell is the active CRM and stops entering new data in Knock. FlitStack performs a final delta pass to capture any records created or updated in the final hours of the Knock-to-Nutshell overlap. A post-migration validation report is delivered showing record counts in Nutshell vs. the original Knock export, a list of any records that failed to migrate with error codes, and a list of owner-resolution mismatches. If reconciliation reveals data integrity issues, FlitStack executes a one-click rollback — removing migrated records from Nutshell so the team can address root causes and re-run. The rollback capability remains available for 72 hours post-cutover.
Platform deep dives
Knock CRM
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 Knock CRM 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
Knock CRM: Not publicly documented.
Data volume sensitivity
Knock 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 Knock CRM to Nutshell migration scoping. Not seeing yours? Book a call.
Walk through your Knock 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 Knock 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.