Export Data from Netcore to Zoho CRM

Export Netcore CE events to Zoho CRM as Tasks, Calls, or Meetings.

Overview

An export transfer creates a Zoho CRM activity each time a Netcore CE event occurs. The activity links to the matching Zoho Lead, Contact, Account, or Deal. Each transfer maps one event to one activity type. For different activity types, create separate transfers.

Example: A high-value cart abandonment creates a high-priority follow-up Task for the matching Contact's owner in Zoho.

ItemDetail
SourceOne Netcore CE event, behavioural or engagement
DestinationA Zoho CRM Task, Call, or Meeting
Location in Netcore CESettings > Integrations > Zoho CRM > Data Transfers
Sync typeReal-time only
Wizard stepsSetup, Event configuration, Field mapping, Test (optional), Activation

Pre-requisites

  • An active Zoho CRM connection. See Zoho CRM.
  • A Netcore CE event with a user identifier. Netcore CE does not export unidentified events.
  • A matching record in Zoho. Netcore CE never creates a Lead, Contact, or Account.

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. It must be unique within the Zoho connection.
Zoho connectionSelect an active connection.
Netcore event categoryBehavioural event, for example Cart Abandoned. Or Engagement event, for example Email Clicked.
Source eventSelect one event. Netcore CE checks every occurrence for export.
Zoho activity typeTask, Call, or Meeting. Choose one.
Associated Zoho moduleThe parent module: Lead, Contact, Account, or Deals. The activity appears in that record's timeline.
Sync typeReal-time. This is the only option.

Note: If you change the activity type after you start mapping, Netcore CE asks you to confirm. It then clears your field mappings.

Click Next.

Step 2: Event Configuration

Add Event Filters (Optional)

Filters decide which occurrences create an activity. For example, Event = Email clicked. You can filter on event system properties, event attributes, campaign or journey metadata, and channel metadata.

Match the Parent Record

  1. 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.
  2. Map it to a field on the Zoho parent module. For example, Netcore Email to Zoho Contact Email.

Netcore CE searches the parent module. It creates the activity only when it finds exactly one match.

ScenarioResult
The event has no identifierThe export fails.
No matching Zoho recordThe export fails with Parent_Record_Not_Found.
More than one matchThe export fails with Multiple_Parent_Records_Found.
The matching field no longer existsThe transfer shows a configuration error.

Set the Activity Owner

Choose Use parent record owner (the default) or Select a fixed Zoho user. If the owner is inactive at runtime, activity creation fails, unless Zoho applies a valid fallback owner. You cannot map the owner from an event attribute.

Click Next.

Step 3: Field Mapping

Netcore CE loads the fields of your Task, Call, or Meeting from Zoho. If your Zoho admin changes a custom field, click Refresh fields.

Fill each Zoho field from one of these sources:

  • An event system property, such as event name, occurrence ID, timestamp, user identifier, channel, or campaign or journey name or ID
  • An event attribute
  • Campaign or journey metadata
  • A static value
  • A calculated date or time
  • The parent record owner

Netcore CE flags mandatory fields. You cannot activate the transfer until each one has a valid mapping. For picklist fields, such as Task Priority, select a value from the list Zoho returns.

Date and Time Fields

Set a date or time field from the event timestamp, a date event attribute, the timestamp plus an offset, or a start time plus a duration.

ExampleSetting
Task due dateEvent timestamp + 1 day
Call start timeEvent timestamp
Meeting end timeMeeting start time + 30 minutes

Netcore CE converts timestamps to your Zoho organization's format and time zone. The end time must be later than the start time. An invalid timestamp fails that record.

Note: A Meeting creates a Zoho activity only. It does not send invitations or calendar emails.

Missing Values

Netcore CE leaves out a missing optional value. A missing mandatory value fails the export. A fallback static value replaces a missing event attribute.

Step 4: Test Configuration (Optional)

The Test configuration action appears when you map the identifier and the mandatory fields.

  1. Enter a Netcore user identifier, or select a recent sample occurrence.
  2. Review the preview. It shows the event payload, the matched Zoho record, and the activity payload.
  3. Click Run test. Netcore CE creates the activity and returns its ID.

Note: Zoho cannot run a validation-only test, so the test creates a real activity. Netcore CE adds [Netcore Test] to its subject or title, unless you override it. Test records do not count in transfer metrics.

Step 5: Activation

  • Click Start Transfer to activate the transfer.
  • Click Save as Draft to store an incomplete setup.

Netcore CE checks that:

  • The connection, source event, activity type, parent module, identifier mapping, and mandatory mappings are in place.
  • The static picklist values and Zoho fields still exist.
  • The configured owner is active.
  • No identical transfer is running.
  • No more than 15 export transfers run at once for the dashboard and Zoho connection. This is the default limit.

Export Status and Monitoring

StateMeaningActions
DraftYou saved the setup but did not start it.Edit, Duplicate, Remove
RunningNetcore CE is exporting events.View, Stop, Duplicate
StoppedThe transfer has ended for good.View, Duplicate, Remove
FailedThe connection, module, field, or permission is no longer valid.View error, Duplicate, Stop
PausedThe transfer is on hold.View, Duplicate, Resume, Remove
CompletedThe transfer has finished.View, Duplicate, Remove

You cannot edit a Running transfer. Stop it or duplicate it to change the setup.

Netcore events do not change after they happen. Each new occurrence creates a new Zoho activity. A later occurrence never updates an earlier one. Stopping a transfer, or deleting an event, does not delete activities already in Zoho.

The listing page shows metrics for each transfer, with a duration filter. They include total eligible events, exported, failed, and deduplicated events, last processed time, and last error time.

Each failed record has a log entry. It shows the event and occurrence ID, the Netcore identifier, the Zoho module and activity type, the error category and reason, the raw Zoho error, and the retry status.

Error Handling

Netcore CE retries automaticallyNetcore CE does not retry
Rate_Limit_ExceededParent_Record_Not_Found
Network_TimeoutMultiple_Parent_Records_Found
Temporary Zoho_API_ErrorMandatory_Field_Missing
Temporary connection failuresData_Type_Mismatch
Invalid_Picklist_Value
Destination_Field_Not_Found
Permission_Denied

Other categories are Authentication_Error, Owner_Not_Available, Payload_Validation_Failed, and Internal_Processing_Error.

Automatic retries use exponential back-off. They reuse the original event occurrence ID with an idempotency key of transfer ID plus occurrence ID. A retry never creates a duplicate Zoho activity.

FAQs

How do I export Netcore CE events to Zoho CRM?

Go to Settings > Integrations > Zoho CRM > Data Transfers and click Create New Transfer. Select a Netcore event and a Zoho activity type. Then complete the remaining steps.

Can I create several activity types from one event?

Yes. Create a separate transfer for each activity type.

Does Netcore CE create a new Lead or Contact in Zoho?

No. Netcore CE creates an activity only when it finds exactly one matching parent record.

Does a Meeting send an invitation?

No. A Meeting creates a Zoho activity only.

Can I run a scheduled or historic export?

No. Exports run in real time only.

Can I edit a Running transfer?

No. Stop the transfer or duplicate it, then change the setup.

Related Pages


Did this page help you?