> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Zoho CRM Connector

## Intro

Zoho CRM is a customer relationship management application with features like procurement, inventory, and some accounting functions from the realm of ERP. To learn more about the Zoho CRM API, visit their page ([https://www.zoho.com/crm/help/api/api-methods.html](https://www.zoho.com/crm/help/api/api-methods.html "https://www.zoho.com/crm/help/api/api-methods.html")).

The Zoho CRM connector is a "Cloud App" connector, meaning it retrieves data stored in the cloud. In the Data Center, you can access the connector page for this and other Cloud App connectors by clicking **Cloud App** in the toolbar at the top of the window.

You connect to your Zoho CRM account in the Data Center. This topic discusses the fields and menus that are specific to the Zoho CRM connector user interface. General information for adding DataSets, setting update schedules, and editing DataSet information is discussed in [Adding a DataSet Using a Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Connector").

<table class="mt-responsive-table" data-aura-rendered-by="33:195;a"><tbody><tr><td class="mt-noheading" colspan="1" rowspan="1"><p><b> Primary Use Cases </b></p></td><td class="mt-noheading" colspan="1" rowspan="1"><p> This connector lets you track your sales pipeline, categorize leads, manage inventory, and keep on top of sales procurement. </p></td></tr><tr><td class="mt-noheading" colspan="1" rowspan="1"><p><b> Primary Metrics </b></p></td><td class="mt-noheading" colspan="1" rowspan="1"><ul><li><p> Number of prospects </p></li><li><p> Number of new customers </p></li><li><p> Number of retained customers </p></li><li><p> Close rate </p></li><li><p> Renewal rate </p></li><li><p> Sales calls made </p></li><li><p> Sales calls per opportunity </p></li><li><p> Sales stage duration </p></li><li><p> Sales cycle duration </p></li><li><p> Proposals given </p></li><li><p> Customer lifetime value </p></li><li><p> Upsell ratio </p></li></ul></td></tr><tr><td class="mt-noheading" colspan="1" rowspan="1"><p><b> Primary Company Roles </b></p></td><td class="mt-noheading" colspan="1" rowspan="1"><ul><li><p> Sales </p></li><li><p> Marketing </p></li></ul></td></tr><tr><td class="mt-noheading" colspan="1" rowspan="1"><p><b> Average Implementation Time </b></p></td><td class="mt-noheading" colspan="1" rowspan="1"><p> some stuff </p></td></tr><tr><td class="mt-noheading" colspan="1" rowspan="1"><p><b> Ease of Use (on a 1-to-10 scale with 1 being easiest) </b></p></td><td class="mt-noheading" colspan="1" rowspan="1"><p> some stuff </p></td></tr></tbody></table>

## Prerequisites

To connect to your Zoho CRM account and create a DataSet, you must have the client ID and client secret associated with your Zoho CRM account.

#### To obtain your client id and client secret:

1. First, log into your [Zoho CRM](https://accounts.zoho.com/signin?servicename=AaaServer\&serviceurl=%2Fdeveloperconsole "Zoho CRM") account.
2. Visit the Zoho API Console and click the **Get Started** button.
3. Select the Client Type.
4. Provide the client details and click **Create**.

Your client id and client secret will appear.

<Note>
  **Note**: Use the redirect URI as [https://oauth.domo.com/api/data/v2/oauth/providers/zoho-enterprise/exchange](https://oauth.domo.com/api/data/v2/oauth/providers/zoho-enterprise/exchange "https://oauth.domo.com/api/data/v2/oauth/providers/zoho-crm-enterprise/exchange")
</Note>

## Connecting to Your Zoho CRM Account

This section enumerates the options in the **Credentials** and **Details** panes in the Zoho CRM Connector page. The components of the other panes in this page, **Scheduling** and **Name & Describe Your DataSet**, are universal across most connector types and are discussed in greater length in [Adding a DataSet Using a Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Connector").

### Credentials Pane

This pane contains fields for entering credentials to connect to your Zoho CRM account. The following table describes what is needed for each field:

<table border="1" data-aura-rendered-by="33:195;a"><thead><tr><th colspan="1" rowspan="1"> Field Name </th><th colspan="1" rowspan="1"> Description </th></tr></thead><tbody><tr><td colspan="1" rowspan="1"> Client ID </td><td colspan="1" rowspan="1"> Enter the client ID associated with your Zoho CRM account. </td></tr><tr><td colspan="1" rowspan="1"> Client Secret </td><td colspan="1" rowspan="1"> Enter the client secret associated with your Zoho CRM account. </td></tr><tr><td colspan="1" rowspan="1"> Zoho CRM Edition </td><td colspan="1" rowspan="1"><span> Select the Zoho CRM Edition. </span></td></tr><tr><td colspan="1" rowspan="1"> Domain </td><td colspan="1" rowspan="1"><span> Select your Zoho CRM domain. To find your domain, log into </span><a href="https://accounts.zoho.com/signin" target="_blank"> Zoho </a><a href="https://accounts.zoho.com/signin" target="_blank" title="CRM"> CRM </a><span><a href="https://accounts.zoho.com/signin" target="_blank" title="CRM" /> and observe the host address. </span><br /><b> Example: </b><span> After logging in, if your host address is <a href="https://abc.zoho.com.au/" rel="noopener" target="_blank"> [https://abc.zoho.com.au/](https://abc.zoho.com.au/) </a>, your domain would be AU. </span></td></tr></tbody></table>

Once you have entered valid Zoho CRM credentials, you can use the same account any time you go to create a new Zoho CRM DataSet. You can manage connector accounts in the **Accounts** tab in the **Data Center**. For more information about this tab, see [Manage Connector Accounts](https://domo-support.domo.com/s/article/360042926054?language=en_US "Manage Connector Accounts").

### Details Pane

This pane contains a primary **Method** menu, in which you specify the data you want to retrieve. Depending on the selected method, various other menus may appear.

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:195;a"><thead><tr><th colspan="1" rowspan="1"><p><span class="s1"><b> Menu </b></span></p></th><th colspan="1" rowspan="1"><p><span class="s1"><b> Description </b></span></p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Method </p></td><td colspan="1" rowspan="1"><p><span class="s1"> Select the Zoho CRM data you want to retrieve. The following methods are available: </span></p><table border="1" cellpadding="1" cellspacing="1"><tbody><tr><td colspan="1" rowspan="1"> Attachments </td><td colspan="1" rowspan="1"> Returns a list of attachments </td></tr><tr><td colspan="1" rowspan="1"> Custom View Records </td><td colspan="1" rowspan="1"> Returns the custom views data of a particular module </td></tr><tr><td colspan="1" rowspan="1"> Deleted Records </td><td colspan="1" rowspan="1"> Returns a list of deleted records </td></tr><tr><td colspan="1" rowspan="1"> Fields </td><td colspan="1" rowspan="1"> Returns the field meta data for the specified module </td></tr><tr><td colspan="1" rowspan="1"> Layouts </td><td colspan="1" rowspan="1"> Returns the layouts associated with the particular module </td></tr><tr><td colspan="1" rowspan="1"> Modules </td><td colspan="1" rowspan="1"> Returns a list of modules available in the CRM account. </td></tr><tr><td colspan="1" rowspan="1"> Notes </td><td colspan="1" rowspan="1"> Returns a list of notes </td></tr><tr><td colspan="1" rowspan="1"> Organizations </td><td colspan="1" rowspan="1"> Returns the organization data </td></tr><tr><td colspan="1" rowspan="1"> Profiles </td><td colspan="1" rowspan="1"> Returns the data of profiles </td></tr><tr><td colspan="1" rowspan="1"> Records </td><td colspan="1" rowspan="1"> Returns a list of available records from a module </td></tr><tr><td colspan="1" rowspan="1"> Related List </td><td colspan="1" rowspan="1"> Returns the related list data of a particular module </td></tr><tr><td colspan="1" rowspan="1"> Related Records </td><td colspan="1" rowspan="1"> Returns the related list records </td></tr><tr><td colspan="1" rowspan="1"> Roles </td><td colspan="1" rowspan="1"> Returns the data of roles </td></tr><tr><td colspan="1" rowspan="1"> Search Records </td><td colspan="1" rowspan="1"> Returns the records that matches the search criteria </td></tr><tr><td colspan="1" rowspan="1"> Search using COQL </td><td colspan="1" rowspan="1"> Returns the records that matches the search criteria query </td></tr><tr><td colspan="1" rowspan="1"> Tags </td><td colspan="1" rowspan="1"> Returns all the tags information in an organization </td></tr><tr><td colspan="1" rowspan="1"> Users </td><td colspan="1" rowspan="1"> Returns the list of users in your organization </td></tr></tbody></table></td></tr><tr><td colspan="1" rowspan="1"><p><span class="s1"> Module </span></p></td><td colspan="1" rowspan="1"><p><span class="s1"> Select the Zoho CRM module to pull data from. </span></p></td></tr><tr><td colspan="1" rowspan="1"> Approval State </td><td colspan="1" rowspan="1"> Select the approval status to get a list of records of that status. </td></tr><tr><td colspan="1" rowspan="1"><p><span class="s1"> Deleted Record Type </span></p></td><td colspan="1" rowspan="1"><table border="1"><tbody><tr><th colspan="1" rowspan="1"> Report </th><th colspan="1" rowspan="1"> Description </th></tr><tr><td colspan="1" rowspan="1"> All </td><td colspan="1" rowspan="1"> Returns a list of all deleted records </td></tr><tr><td colspan="1" rowspan="1"> Permanent </td><td colspan="1" rowspan="1"> Returns a list list of permanently deleted records </td></tr><tr><td colspan="1" rowspan="1"> Recycle </td><td colspan="1" rowspan="1"> Returns a list of deleted records from recycle bin </td></tr></tbody></table></td></tr><tr><td colspan="1" rowspan="1"><p><span class="s1"> Record ID </span></p></td><td colspan="1" rowspan="1"><span> Select the Record Id. </span></td></tr><tr><td colspan="1" rowspan="1"><p><span class="s1"> Related List API Name </span></p></td><td colspan="1" rowspan="1"><span> Select the Related List Api Name. </span></td></tr><tr><td colspan="1" rowspan="1"><p><span class="s1"> Search Parameter </span></p></td><td colspan="1" rowspan="1"><span> Select the search parameter. </span></td></tr><tr><td colspan="1" rowspan="1"><p><span class="s1"> Past Days </span></p></td><td colspan="1" rowspan="1"> Enter the number of days of data to retrieve. For example, entering <span class="mt-font-courier-new"> 30 </span> would pull data for the last 30 days. </td></tr><tr><td colspan="1" rowspan="1"><p><span class="s1"> Search Condition </span></p></td><td colspan="1" rowspan="1"><p><span class="s1"><span> Enter the search statement to pull data for. </span></span></p><table border="1"><tbody><tr><td colspan="1" rowspan="1" /><td colspan="1" rowspan="1"><b> Format </b></td><td colspan="1" rowspan="1"><b> Example </b></td></tr><tr><td colspan="1" rowspan="1"> Email </td><td colspan="1" rowspan="1"><span class="s1"><span><a href="mailto:username@domain.com"> [username@domain.com](mailto:username@domain.com) </a></span></span></td><td colspan="1" rowspan="1"><span class="s1"><span><a href="mailto:daly@zylker.com"> [daly@zylker.com](mailto:daly@zylker.com) </a></span></span></td></tr><tr><td colspan="1" rowspan="1"> Phone </td><td colspan="1" rowspan="1"><span class="s1"><span> xxx-xxx-xxxx </span></span></td><td colspan="1" rowspan="1"><span class="s1"><span> 888-555-2145 </span></span></td></tr><tr><td colspan="1" rowspan="1"> Word </td><td colspan="1" rowspan="1"><span class="s1"><span> Search Word </span></span></td><td colspan="1" rowspan="1"><span class="s1"><span> test </span></span></td></tr><tr><td colspan="1" rowspan="1"> Criteria </td><td colspan="1" rowspan="1"><span class="s1"><span> (({apiname}:{starts_with|equals}:{value}) and ({apiname}:{starts_with|equals}:{value})) </span></span></td><td colspan="1" rowspan="1"><p><span class="s1"> (Last\_Name:equals:Boyle) for Lead Module </span></p><p><span class="s1"><span> will search the Last\_Name column for rows equaling Boyle </span></span></p></td></tr></tbody></table><p><span class="s1"><span> See </span><a href="https://www.zoho.com/crm/help/api/v2/#ra-search-records" target="_blank" title="Zoho API Help Link"> Zoho API Help Link </a><span> for more help. </span></span></p></td></tr><tr><td colspan="1" rowspan="1"> Custom View Name </td><td colspan="1" rowspan="1"><span> Select the Custom View Name to get the list of records based on custom views. </span></td></tr><tr><td colspan="1" rowspan="1"> User Type </td><td colspan="1" rowspan="1"><p> Select the user type you want to pull data for. </p><table border="1"><tbody><tr><td colspan="1" rowspan="1"> Active Confirmed Users </td><td colspan="1" rowspan="1"> Returns the list of active users who are also confirmed </td></tr><tr><td colspan="1" rowspan="1"> Active Users </td><td colspan="1" rowspan="1"> Returns a list of list of all Active Users </td></tr><tr><td colspan="1" rowspan="1"> Admin Users </td><td colspan="1" rowspan="1"> Returns the the list of admin users </td></tr><tr><td colspan="1" rowspan="1"> All Users </td><td colspan="1" rowspan="1"> Returns the the list of All users </td></tr><tr><td colspan="1" rowspan="1"> Confirmed Users </td><td colspan="1" rowspan="1"> Returns the list of confirmed users </td></tr><tr><td colspan="1" rowspan="1"> Current User </td><td colspan="1" rowspan="1"> Returns the the list of current CRM users </td></tr><tr><td colspan="1" rowspan="1"> Deactivated Users </td><td colspan="1" rowspan="1"> Returns a list of all users who were deactivated </td></tr><tr><td colspan="1" rowspan="1"> Deleted Users </td><td colspan="1" rowspan="1"> Returns the list of deleted users </td></tr><tr><td colspan="1" rowspan="1"> Not Confirmed Users </td><td colspan="1" rowspan="1"> Returns the list of non-confirmed users </td></tr></tbody></table></td></tr></tbody></table>

### Schema

Using the schema menu, the customers will be able to alter the schema type for any column, thereby, allowing them to change the column type to Double and fix it seamlessly.

### Other Panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see [Adding a DataSet Using a Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Connector").

## Troubleshooting

Issues sometimes arise with this connector from permissions problems. If any data is missing for any reason, then most likely the credentials being used for the connector have fewer permissions than expected. Either enter credentials with full Zoho CRM system access or, through Zoho CRM, provide the account linked to Domo with the proper access.

## API Limits

Free Edition

* 1000 requests/day/organization

Standard Edition

* Min - 2000 requests/day/organization
* Max - 5000 requests/day/organization or 250 requests /user license whichever is lower

Professional Edition

* Min - 3000 requests/day/organization
* Max - 10000 requests/day/organization or 250 requests /user license whichever is lower

Enterprise Edition

* Min - 4000 requests/day/organization
* Max - 25000 requests/day/organization or 500 requests /user license whichever is lower

Zoho CRM will notify CRM administrators (Users with "Administrator" profile) if your organization exceeds the API limit. They also provide API statistics for better assessment of your integration requirements.

## FAQs

<AccordionGroup>
  <Accordion title="What version of the ZohoCRM API does this connector use?">
    This connector uses version 2.0 of the Zoho CRM API.
  </Accordion>

  <Accordion title="What kind of credentials do I need to power up this connector?">
    You need your Zoho CRM client id and client secret. You also need to select the Zoho CRM edition.
  </Accordion>

  <Accordion title="Where can I find my client id and client secret?">
    To obtain your client id and client secret, do the following:

    1. log into your Zoho CRM account.
    2. Visit the Zoho API Console and click the **Get Started** button.
    3. Select the Client Type.
    4. Provide the client details and click **Create**.

       Your client id and client secret will appear.
  </Accordion>

  <Accordion title="What is the redirect URI for Zoho CRM?">
    The redirect URI for Zoho CRM is [https://oauth.domo.com/api/data/v2/oauth/providers/zoho-enterprise/exchange](https://oauth.domo.com/api/data/v2/oauth/providers/zoho-enterprise/exchange "https://oauth.domo.com/api/data/v2/oauth/providers/zoho-enterprise/exchange").
  </Accordion>

  <Accordion title="How often can the data be updated?">
    As often as needed.
  </Accordion>

  <Accordion title="Are there any API limits that I need to be aware of?">
    No.
  </Accordion>
</AccordionGroup>
