Zoho CRM – Gotchas

Service ID: zoho-crm

Zoho makes it easy to get the complete picture of your sales cycle and stay on top of your business opportunities. Never lose another lead again.

⚠️

10 gotchas across 7 resources

These are connector-specific behaviors and limitations to be aware of when integrating.

Activities2 gotchas

allactivitiesAll

Zoho CRM's info.count in list responses is a per-page count only, not a cross-page total. meta.total_count will not appear. Zoho CRM activities are backed entirely by the Events module (/v2.1/Events), so every activity is returned with type: meeting regardless of how it was created. Other activity types (note, call, task, email) are not represented. To read notes, use the dedicated /crm/notes resource (mapped to Zoho's /v5/Notes).

addactivitiesAdd

Zoho CRM maps all activities to the Events module (POST /v2.1/Events) regardless of the type value. An activity created with type: note, call, task, or email is still stored as a Zoho Event (a calendar entry), and reads of /crm/activities return only Events. To log a note against a record, use the dedicated /crm/notes resource (mapped to Zoho's /v5/Notes) instead.

Companies1 gotcha

allcompaniesAll

Zoho CRM's info.count in list responses is a per-page count only, not a cross-page total. meta.total_count will not appear.

Contacts2 gotchas

allcontactsAll

When using the phone_number filter for contacts in Zoho CRM, the filter does not work with numbers containing dashes (e.g., 989-989-989) or their URL-encoded equivalents (e.g., 989%2D989%2D989). It only works with continuous digits (e.g., 9898989898).

allcontactsAll

Zoho CRM's info.count in list responses is a per-page count only, not a cross-page total. meta.total_count will not appear.

Leads2 gotchas

allleadsAll

When using the phone_number filter for leads in Zoho CRM, the filter does not work with numbers containing dashes or plus (e.g., +989-989-989) or their URL-encoded equivalents (e.g., %2B989%2D989%2D989). It only works with continuous digits (e.g., 9898989898).

allleadsAll

Zoho CRM's info.count in list responses is a per-page count only, not a cross-page total. meta.total_count will not appear.

Notes1 gotcha

allnotesAll

Zoho CRM's info.count in list responses is a per-page count only, not a cross-page total. meta.total_count will not appear.

allopportunitiesAll

Zoho CRM's info.count in list responses is a per-page count only, not a cross-page total. meta.total_count will not appear.

Users1 gotcha

allusersAll

Zoho CRM's info.count in list responses is a per-page count only, not a cross-page total. meta.total_count will not appear.