Skip to main content

How to Configure Your Zoho Integration

Complete guide to configure your Zoho CRM integration in Enginy: sync settings, field mapping, campaign mapping, and user mapping.

Zoho is a CRM suite with sales automation and analytics. Follow the steps below to connect Zoho to Enginy and configure the integration.

To set up your Zoho integration:

  1. Go to Integrations and open the All tab (or the Disabled tab).

  2. Locate the Zoho card and enable it using the toggle switch.

  3. Click the Configure button on the Zoho card.

A floating setup window opens with four sequential steps.

Important: You can only have one CRM integration active at a time. If another CRM is already active, disable it first.



Step 1: Sync Configuration

This step defines how Enginy matches contacts and companies with your Zoho records to prevent duplicates and ensure data integrity. A sync means Enginy compares its records against Zoho records using the identifiers you configure here.



Integration User

It shows whose email address is the API integration user.



Contact Identifier

Choose how Enginy determines whether a contact already exists in your Zoho.

Option

Matching Logic

First name + Last name + Company name

A contact matches when all three fields are the same in both Enginy and Zoho.

LinkedIn profile URL OR First name + Last name + Company name

A contact matches if the LinkedIn profile URL is the same or all three name/company fields match.

Custom Mapping

Opens a pop-up where you define custom conditions using AND/OR logic (for example, match by First Name AND Last Name, OR by Professional Email).



Company Identifier

Choose how Enginy determines whether a company already exists in your Zoho.

Option

Matching Logic

Domain

Matches on the company domain (e.g., enginy.ai). You can also check the box Include any domain extension to treat .com, .es, .org, etc. as equivalent.

Domain or Company Name

Matches if either the domain or the company name is the same.

Custom Mapping

Opens a pop-up where you define custom conditions (for example, match by Domain OR Company LinkedIn URL).




General

Under General, you'll find two toggles that control how associations are handled during export:

  • When exporting contacts, associate them with companies in Zoho: If enabled, Enginy will automatically link exported contacts to their corresponding companies in Zoho.

  • When exporting companies, associate them with contacts in Zoho: If enabled, Enginy will automatically link exported companies to their related contacts in Zoho.



Step 2: Field Mapping

This step configures which Enginy fields map to which Zoho fields when exporting data. The setup is split into three tabs — Contacts, Leads and Companies — and the mapping configuration works the same way in both.



Field Types

Field Type

Description

Enginy Fields

Standard fields from your contact or company lists (e.g., Phone Number, Job Title). Click Add field to add a mapping: select the Enginy field first, then the corresponding Zoho field.

Fixed Value Fields

Fields that always export with the same static value. For example, create a field called "Source" with fixed value "Enginy" so every exported record is tagged with its origin.

Manual Export Fields

Fields whose value you define at the time of export. Click Add field, select the Zoho field to be set when exporting. As many as you want.

Engagement Fields

Fields populated when an Activity is created in Zoho (e.g., an email sent, a LinkedIn message, or a Task log). Select the Zoho field and set the Value to export. Only one can be set.



Warning: Don't map a Company field in the Contacts tab (or a Contact field in the Companies tab). This can cause export errors. If you must map the same field in both tabs, make sure it's mapped the same in both places.


In each Zoho field mapping dropdown, you'll see small status icons indicating whether the mapping is supported, not supported, or supported with limitations / a workaround.

Icon

Meaning

Blue check

The mapping is okay, has no potential problems.

Yellow exclamation

The field types in Enginy and Zoho may be incompatible (e.g., an Enginy Text field mapped to a Zoho Enumeration field).

Red X

The mapping can't be applied because the types don't match — or because the Zoho field is read-only and can't be updated.


Mapping Options

Option

Behaviour

Enginy overwrites Zoho

Changes in Enginy automatically overwrite the corresponding fields in Zoho.

Sync with Zoho

Data only syncs automatically when the destination field is empty, preventing overwriting existing values.



Export options

When exporting manually a contact or a company, the Export to CRM modal shows the following options:

  • Lead / Contact toggle: In the top-right corner of the modal, you can switch between exporting the selected records as Lead or Contact in Zoho CRM.

  • Owner: Select a Zoho user as the owner of the exported records. This field is optional — if left empty, the default owner from your User Mapping configuration will be used. You can also check Overwrite existing value to replace the current owner in Zoho.

  • Export associated company: Enable this toggle to export the contact's company as an Account record in Zoho at the same time.

  • Overwrite existing values: Expand this section to see all your mapped fields organized in two tabs — Contacts and Companies. Check the Overwrite existing value box next to each individual field you want to update in Zoho. Fields left unchecked will only be populated if they are currently empty in Zoho.

  • Review Mapping: Click this button to review your field mapping configuration before confirming the export.​





Step 3: Campaign Mapping (Optional)

This step lets you sync campaign-specific properties to Zoho. These are not standard list fields; they are properties tied to campaign activity.

Sequence

Property

What It Contains

Example Value

Campaign Sequence Details

The steps included in the campaign.

1st Email, 2nd Email, LinkedIn Connection Request, 1st LinkedIn

Campaign Engagement Status

The current status of each lead in the campaign.

Added to Campaign, Message Sent (1/3) - Email, Message Replied (3/3) - LinkedIn

Sequence Status

The overall status of the campaign sequence for the lead.

Not Started, Ongoing, Replied, Finished

Campaign Reply Analysis

Indicates per-message whether the lead replied to each automated message.

No, Yes (1st Message), Yes (2nd Message)


Email

Property

What it Contains

Example Value

Campaign Opens

Total number of times a lead has opened one or more emails in the campaign.

3

Campaign Clicks

Total number of times a lead has clicked a link in campaign emails.

1

Campaign Open Analysis

Indicates per-message whether the contact opened that specific email.

No, Yes (1st Message), Yes (2nd Message)

Campaign Click Analysis

Indicates per-message whether the contact clicked a link in that specific email.

No, Yes (1st Message)


General

Property

What it Contains

Example Value

Campaign

All Campaign names the contact has been added to.

UK Hiring Campaign, Italian SDR Campaign, Jordi's Campaign

Senders

All sender names that have contacted the contact.

Adham Elman, Giulio Gargano, Jordi Casas

Activities

All activities that have occurred with the contact.

Visit LinkedIn profile, LinkedIn Invitation sent, Contact has accepted invitation, ...


Conversation Tags

Property

What it Contains

Example Value

Conversation Tags

All conversation tags applied to the contact (comma-separated).

Contacted, Positive, Meeting Booked

Conversation Tags Categories

Categories of conversation tags: POSITIVE, NEUTRAL, NEGATIVE (comma-separated).

POSITIVE, POSITIVE, POSITIVE



Step 4: User Mapping

This final step defines the associations between Enginy users/identities and Zoho users so that exports and activity logs are attributed to the correct people.



Identities Mapping

An Identity in Enginy is the profile that runs a campaign (for example, a LinkedIn profile or an email sender). Identities Mapping links each Enginy identity to a Zoho user.

When a campaign performs a sync or export, the Zoho activity log shows the associated Zoho user as the one who executed the action.



Users Mapping

Users Mapping links an Enginy user account to a Zoho user. This sets the default owner for any record exported by that user — even for automatic exports via field mappings, not just manual exports.

If Zoho users have different permission levels, this association respects those limits. A record exported by an Enginy user is owned by the mapped Zoho user and governed by that user's permissions.


Default CRM owner

This mapping sets a default Zoho owner (contact or company owner) for exports performed by an Enginy user who isn't mapped in User Mapping.



Save Your Configuration

After completing all four steps, click Update to save your Zoho configuration.

Did this answer your question?