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.

ItemDetail
SourceA Zoho CRM module
DestinationNetcore CE Contacts or Events
Location in Netcore CESettings > Integrations > Zoho CRM > Data Transfers
Sync typeReal-time. Historic sync for Contacts only.
Wizard stepsSetup, 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

  1. Go to Settings > Integrations > Zoho CRM > Data Transfers.
  2. Click Create New Transfer.
Field nameDescription
Transfer nameA default name, Data transfer_YYYYMMDDHHmmss. You can edit it.
Zoho moduleLeads, Contacts, Accounts, Deals, Tasks, Calls, or Meetings. Netcore adds custom modules by API name.
Netcore entityContact or Events.
Transfer triggerOn 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)

  1. Click Add Filter.
  2. Select a Zoho field and an operator.
  3. Enter the value.
Field typeOperators
Integer, Float (including Currency)Equal to, Greater than, Less than
String, URL, PicklistIs, Is not
Date, DateTimeBefore, 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

OptionWhat it does
Add ContactAdds synced records to the contact master and updates existing contacts. You can also add them to up to 5 lists.
Remove ContactRemoves synced records from the contact master, or from up to 5 lists.

Events: Select the Event

  1. Select an existing Netcore event, or type a name to create one. For example, Deal Lost.
  2. 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.
  3. 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.Email on a Deal.

Click Next.

Step 3: Field Mapping (Contacts Only)

  1. 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.
  2. Map more fields. In each row, select a Zoho field and a Netcore attribute.

To create a Netcore attribute:

  1. Click Create New Attribute. A side drawer opens.
  2. Select the Zoho field to base it on.
  3. Review the auto-filled name. It is the Zoho field name in lowercase, with underscores for spaces.
  4. Review the data type. It comes from the Zoho field. You cannot change it.
  5. 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.

  1. Click Test. A side drawer opens.
  2. Enter an identifier value, for example an email address. Netcore CE finds the matching Zoho record.
  3. Review the preview. You can change any value to test edge cases.
  4. 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

StateMeaningActions
RunningThe transfer is live.Stop, Duplicate
DraftYou saved the transfer but did not start it.Edit, Duplicate, Remove
StoppedThe transfer has ended for good.Duplicate, Remove
In QueueThe 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 typeWhat Netcore CE does
Real-time, payload errorRetries up to 4 times. It halves the batch size on each retry, down to 1.
Real-time, queue fullReschedules after a default delay, for example 5 minutes.
Historic, Zoho rate limitStops the batch. Retries after 1, 2, 4, 8, and then 10 minutes.
Account Suspended, Authentication Required, Blocked Client, Unsupported Media Type, Missing IdentifierDoes 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


Did this page help you?