Import Data from Zoho CRM to Netcore
Sync Zoho CRM records into Netcore CE as Contacts or Events.
Overview
An import transfer reads records from a Zoho CRM module and adds them to Netcore CE. New and changed records sync in real time. For Contacts, you can also backfill existing Zoho records with a historic sync.
| Item | Detail |
|---|---|
| Source | A Zoho CRM module |
| Destination | Netcore CE Contacts or Events |
| Location in Netcore CE | Settings > Integrations > Zoho CRM > Data Transfers |
| Sync type | Real-time. Historic sync for Contacts only. |
| Wizard steps | Setup, Data configuration, Field mapping (Contacts only), Test (optional), Activation |
Pre-requisites
- An active Zoho CRM connection. See Zoho CRM.
- Access to the Zoho module you want to import from.
Step 1: Setup
- Go to Settings > Integrations > Zoho CRM > Data Transfers.
- Click Create New Transfer.
| Field name | Description |
|---|---|
| Transfer name | A default name, Data transfer_YYYYMMDDHHmmss. You can edit it. |
| Zoho module | Leads, Contacts, Accounts, Deals, Tasks, Calls, or Meetings. Netcore adds custom modules by API name. |
| Netcore entity | Contact or Events. |
| Transfer trigger | On Update syncs changes to existing records. It also syncs a new record that already has a mapped field filled. On Create or Update syncs all of that, plus every new record. |
Note: A Contact import has a Field mapping step. An Events import skips it. Netcore CE finds event data automatically.
Click Next.
Step 2: Data Configuration
This step controls which Zoho records sync and where they land in Netcore CE.
Add Filters (Optional)
- Click Add Filter.
- Select a Zoho field and an operator.
- Enter the value.
| Field type | Operators |
|---|---|
| Integer, Float (including Currency) | Equal to, Greater than, Less than |
| String, URL, Picklist | Is, Is not |
| Date, DateTime | Before, After, On |
A record syncs only when it meets all conditions. If an operator does not match the field type, Netcore CE shows an error when you click Next.
For a Lookup field, such as a Deal's linked Account, the field list shows the linked object's fields one level deep. They appear as Object: Field, for example Account: Industry.
Contacts: Set the Destination
| Option | What it does |
|---|---|
| Add Contact | Adds synced records to the contact master and updates existing contacts. You can also add them to up to 5 lists. |
| Remove Contact | Removes synced records from the contact master, or from up to 5 lists. |
Events: Select the Event
- Select an existing Netcore event, or type a name to create one. For example,
Deal Lost. - Select the Netcore identifier. On a Standard dashboard, this is your primary key. On an Addressable Anonymous dashboard, choose your primary key, Email, or Mobile.
- Select the Zoho fields to send as event attributes. Linked object fields work here too.
Netcore CE converts Zoho data types automatically. For example, Currency becomes Float. DateTime becomes a Netcore timestamp.
Important: The identifier must come from the primary Zoho object. You cannot use a linked field, such as
Account.Emailon a Deal.
Click Next.
Step 3: Field Mapping (Contacts Only)
- Map the Netcore Contact Identifier to a Zoho field. Netcore CE uses it to match incoming records to existing contacts. Use a field on the primary Zoho object only.
- Map more fields. In each row, select a Zoho field and a Netcore attribute.
To create a Netcore attribute:
- Click Create New Attribute. A side drawer opens.
- Select the Zoho field to base it on.
- Review the auto-filled name. It is the Zoho field name in lowercase, with underscores for spaces.
- Review the data type. It comes from the Zoho field. You cannot change it.
- Click Save and Create.
Click Next.
Step 4: Test Configuration (Optional)
A test checks your mapping and connection with one real record. The Test button stays blocked until you map a Netcore identifier and no data type mismatch exists.
- Click Test. A side drawer opens.
- Enter an identifier value, for example an email address. Netcore CE finds the matching Zoho record.
- Review the preview. You can change any value to test edge cases.
- Click Run Test. Netcore CE sends one record to the Netcore Contact API or Event API.
On success, Netcore CE created or updated the record. On failure, it shows the raw error. For Events, if the user does not exist, Netcore CE creates a shadow contact for the event to attach to.
Step 5: Activation
- Click Start Export to activate the transfer.
- Click Save to store your setup as a Draft.
Netcore CE checks that:
- No more than 15 transfers run at once. This is the default limit.
- Every mapped attribute exists in Netcore CE.
- The identifier maps to a Zoho field with a valid data type.
- No data type mismatch exists.
- No identical transfer is running.
Historic Sync
A historic sync backfills existing Zoho records into Netcore CE Contacts. It is not available for Events.
Start it from the Data Transfer listing page. It is available only when the Contact transfer is Running and no other historic sync is in progress for it. Large backfills run in chunks in the background. Netcore CE respects Zoho's API limits and backs off automatically.
Import Status and Monitoring
| State | Meaning | Actions |
|---|---|---|
| Running | The transfer is live. | Stop, Duplicate |
| Draft | You saved the transfer but did not start it. | Edit, Duplicate, Remove |
| Stopped | The transfer has ended for good. | Duplicate, Remove |
| In Queue | The transfer waits for a free processing slot. | None |
A red exclamation icon on a Running transfer means an error occurred in the last 24 hours.
- View: Shows the setup in read only mode.
- Edit: Changes a Draft. If you change the Netcore entity, Netcore CE resets the later steps.
- Duplicate: Creates a Draft named
Copy of <previous name>. - Remove: Deletes the transfer and its backend job.
Logs and Retry
- Real-time logs: Show the total exported and failed records. Click a failure for its timestamp, record ID, and error message.
- Historic logs: Show the job ID, requested-on time, status, and completed-on time.
- Event errors: Also appear in the Error Logs screen.
| Failure type | What Netcore CE does |
|---|---|
| Real-time, payload error | Retries up to 4 times. It halves the batch size on each retry, down to 1. |
| Real-time, queue full | Reschedules after a default delay, for example 5 minutes. |
| Historic, Zoho rate limit | Stops the batch. Retries after 1, 2, 4, 8, and then 10 minutes. |
| Account Suspended, Authentication Required, Blocked Client, Unsupported Media Type, Missing Identifier | Does not retry. You re-authenticate or retry by hand. |
FAQs
How do I import data from Zoho CRM into Netcore CE?
Go to Settings > Integrations > Zoho CRM > Data Transfers and click Create New Transfer. Select a Zoho module and a Netcore entity. Then complete the remaining steps.
What is the difference between On Update and On Create or Update?
On Update syncs changes to existing records. On Create or Update also syncs every new record.
Does an Events import need field mapping?
No. Only a Contact import has a Field mapping step.
Can I backfill existing Zoho records?
Yes, for Contacts. Start a historic sync from the Data Transfer listing page.
Can I edit a Running transfer?
No. You can edit only Draft transfers. Stop or duplicate the transfer to change it.
Related Pages
Updated 5 days ago
