Beam Help
Get help now

How-to · Zoho CRM

How to get record count in Zoho

Count total records in a module or filtered view.

Getting a record count in Zoho CRM is straightforward when you know which module to target and whether you need a filtered or total count — our AI assistant handles both cases automatically.


Why this matters


Knowing how many records exist in a given module — Leads, Contacts, Deals, and so on — is a common operational need: tracking pipeline size, auditing data quality, or verifying an import. You may also need a filtered count, such as "how many open Deals match a specific criteria," rather than a raw total. Beam Help (independent expert support for Zoho, not official Zoho support) has built tooling that makes this query conversational and instant.


Step-by-step


Step 1. Open the Beam Help chat assistant and make sure your Zoho CRM account is connected. If the integration is not active, you will see an error prompting you to reconnect before any data can be retrieved. [5]


Step 2. Type your count question in plain language. For a total count, something like *"How many records are in the Leads module?"* works well. For a filtered count, include your criteria in the same message — for example, *"How many Deals match [your filter]?"* [1]


Step 3. The assistant identifies the target module and any filter criteria from your message. If it cannot determine the module, it will ask a clarifying question: *"Which module should I count (e.g., Leads, Contacts, Deals)?"* Simply reply with the module name to continue. [3]


Step 4. Once the module is confirmed, the assistant calls the getrecordcount tool internally, passing the module name and — if you supplied one — the criteria string as parameters. [3]


Step 5. The tool executes against your live Zoho CRM data. You will see a brief status message in the chat while the call is in progress. [2]


Step 6. The result is returned in plain language. If no filter was used, you will see a response along the lines of *"You have N records in the [Module] module."* If a filter was applied, the response will confirm the count matches that specific filter. [6]


Step 7. If the tool cannot extract a numeric count from the API response — for example, because the response format was unexpected — the assistant will tell you it could not determine the count for that module, so you can rephrase or try again. [1]


Common pitfalls


  • Module not recognised. If your message is ambiguous (e.g., "How many do I have?"), the assistant cannot infer the module and will pause to ask. Always include the module name in your initial question to avoid the extra round-trip. [^1,3]

  • Zoho not connected. The getrecordcount tool requires an active Zoho CRM connection. If the connection has lapsed, the assistant returns an error — *"Zoho is not connected for this app. Please reconnect."* — and will not proceed until the connection is restored. [3]

  • CRM-only feature. The record count shortcut is scoped to the CRM app type. If you are working in a different Zoho product context within the assistant, the shortcut will not activate and you will need to switch to the CRM context first. [3]

  • Zoho rejects the request. If Zoho CRM returns an error for the API call (for example, due to an invalid criteria string), the assistant will surface the rejection and ask what you would like to adjust before retrying. [6]

What to check


  • Confirm the module name matches exactly what appears in your Zoho CRM setup — custom modules must be referenced by their API name, not just their display label.
  • Verify your Zoho CRM connection is active in the assistant settings before running a count query, to avoid the reconnect error mid-conversation. [^3,5]
  • Review the criteria syntax if you requested a filtered count and the result seems unexpectedly low or high — an incorrectly formed filter string may cause Zoho to reject the request or return zero results. [6]

Sources cited

  1. [1] server.py: _count_shortcut_outcome
  2. [2] server.py: chat_stream
  3. [3] server.py: build_zoho_links
  4. [4] server.py: chat
  5. [5] GET /api/v1/views/{view_id}/records/count
Get Record Count in Zoho | Beam Help