Migrate from Insightly CRM to Zoho CRM

Insightly Organizations map directly to Zoho CRM Accounts. Organization Name becomes Account Name; all address fields (shipping and billing) map to the corresponding Zoho Account address fields. We import Accounts first in every migration to satisfy the parent lookup required by Contact records. Organization Owner maps to Zoho Account Owner by email match against Zoho Users.

Insightly Contacts map 1:1 to Zoho CRM Contacts. All standard fields (First Name, Last Name, Email, Phone, Mobile, Mailing Address) map directly. Prefix maps to Zoho Salutation. We resolve the Contact's parent Account by looking up the Organization name from the Insightly link record and matching it to the Zoho Account created in the prior phase. If multiple Contacts share one Organization, we re-apply the link to each Contact after Account creation.

Insightly Leads map directly to Zoho Leads. Lead Status maps to Zoho Lead Status with a value mapping table applied at migration time. Any custom fields on Insightly Leads are resolved via FIELD_NAME lookup and created as corresponding Zoho custom fields before import. Lead Owner maps to Zoho User by email match.

Insightly Opportunities map to Zoho CRM Deals. Stage name mapping is the most critical step: Insightly uses custom-named stage strings while Zoho uses stage values configured per pipeline. We build a customer-approved stage mapping table during scoping and apply it during migration. Probability percentage maps to Zoho Probability field. Closed-Won and Closed-Lost reasons map to Zoho Loss Reason and Won Reason if those custom fields are present in the destination.

Each Insightly Opportunity pipeline becomes a Zoho CRM pipeline within the Deals module. We replicate stage names and probabilities from Insightly into Zoho's pipeline configuration before migration begins. If the customer has multiple pipelines in Insightly, we create corresponding Zoho pipelines and map Opportunity records to the correct pipeline during import using the pipeline_id field.

Insightly Tags are flat string labels on Contacts, Organizations, Opportunities, and Projects. Zoho CRM supports Tags as a native multi-value field. We export tag arrays as string lists and import them as Zoho Tags. Tag semantics are preserved as-is; no transformation is applied beyond the string array to tag-list conversion.

Insightly Notes are standalone objects that can be linked to any primary record (Contact, Organization, Opportunity, Project). Zoho CRM Notes are attached to records via the Notes module. We preserve note body, author, and creation timestamp. The link to the parent record is reconstructed in Zoho by matching the parent record's Zoho ID at migration time. Notes are imported after parent records (Accounts, Contacts, Deals) are confirmed in the destination.

Insightly Tasks are linked to any primary object. Zoho Tasks attach to records via the Task module's Related To field. Task status values (Not Started, In Progress, Completed, Deferred) require a value mapping table against Zoho's Task Status picklist. Due Date and Priority map directly. Owner maps by email match to Zoho User.

Insightly Projects are not native Zoho CRM objects. If the customer uses Zoho Projects (a separate Zoho application), we can map Insightly Projects to Zoho Projects via API with task structure, custom fields, and status preserved. If the customer uses Zoho CRM without Zoho Projects, we import Projects as a custom Zoho CRM module, preserving project name, status, description, and task hierarchy as a flat record set with a custom task sub-list. Project-to-Opportunity linkage is not preserved as a native relationship in Zoho CRM without Zoho Projects.

Insightly custom fields per object require FIELD_NAME lookup via the /CustomFields/{objectName} endpoint before any write. We retrieve all custom field metadata at the start of every migration, build a FIELD_NAME reference table, create the corresponding custom fields in Zoho CRM (with matching field types: text, date, picklist, multi-select, number, currency, checkbox), then apply field values during record import. Field type compatibility is validated during schema design: Insightly calculated fields become Zoho formula fields where supported.

Insightly uses explicit link records to associate Contacts with Organizations; these links are not embedded in the primary record. Zoho CRM enforces the Account-Contact relationship through a standard lookup field on the Contact record (Account Name). We export Insightly link records separately, import Accounts and Contacts first, then resolve each Contact's AccountId by matching the linked Organization's name to the Zoho Account. We update each Contact record with the resolved AccountId to reconstruct the relationship.