Configure a Zoho CRM integration

Who can use this feature?

A connection is an authentication mechanism to allow Totango to integrate with another system. Each connector has different requirements for connection. You can reuse connections to support multiple integration jobs. 

CRM integrations are a closed system; you cannot reuse CRM connections for other integration families. 

A Zoho CRM connection requires a Zoho Client ID, Client Secret, and Zoho API domain. 

1. Create a Zoho CRM OAuth app

Create a Zoho CRM OAuth app to obtain the required information for the Totango connection.

  1. Log into Zoho developer console.
  2. Click Add Client, and choose Server-based Applications.
  3. In the Create New Client window, enter the following information:
  4. Click Create.
  5. Copy the Client ID and Client Secret fields.

2. Create a Zoho connection in Totango

In the event that your network is behind a firewall, you will need to whitelist our servers so that we may retrieve information from your data warehouse.

  1. In Totango, click Settings from the left nav.
  2. Expand Data Management > Customer Data Hub.
  3. From the list of active connectors (left), choose CRMs.
  4. From the list of available connectors, hover over Zoho CRM, and click Connect (or View Integrations).
  5. Enter a name and description for the connection. Because you can have multiple connections with a connector (using different authentication profiles), a name and description helps you identify the connection later.
  6. Add the Client ID and Client Secret (see above).
  7. Add the Consumer API domain that corresponds:
    • US:
    • AU:
    • EU:
    • IN:
    • CN:
  8. Click Connect.

You can now set up an integration using the connection.

Create an inbound integration job

Totango supports importing data from these Zoho CRM objects:

  1. Accounts
  2. Users (contacts)
  3. Collections (of Campaigns, Deals, Calls, etc.)

See this article for step-by-step instructions.

  1. Choose the data type you want to import and then select the object and the object fields
  2. Add the COQL query in the Query Filter field.

    The COQL query filters the data from Zoho CRM that you want to import to Totango. Totango will execute the COQL query on your Zoho CRM account and import the data resulting from this query.

    See here to learn more on COQL queries. 

  3. Map the source fields with Totango attributes (see below).
  4. Continue with scheduling and settings.
  5. Click Save and Sync.

Default mapping templates

Each integration job is independent and can have different scheduling and mapping. Mapping templates (object, fields, query filter, mappings) automatically default per object, but you can update the mappings as needed.

Mapping templates load automatically when you create a new Zoho CRM accounts (companies) or users (contacts) integration job.

Accounts (companies)


Best practices and known issues

  • It is possible to sync Totango attributes back to Zoho CRM with the write-back capability
  • When working with custom objects in Zoho, write-back will work only if the custom object name starts with a capital letter and all the other letters are small letters (e.g., Custom).
  • Totango uses Zoho V2 APIs to import data into Totango. API limits depend on the customer Zoho license. See more details here.

Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request