Using ZRC in Client Script

Hello everyone!

Welcome to another week of Kaizen. In today's post, lets see what is ZRC (Zoho Request Client) and how we can use ZRC methods in Client Script to get inputs from a Salesperson and update the Lead status with a single button click. 

In this Kaizen post,

---

1. What is ZRC?
2.  ZRC Methods
3. Use Case
4. Solution
5. Summary
6. Related Links

---

1. What is ZRC?

Zoho Request Client (ZRC) is a built-in SDK in Zoho CRM that provides a unified way to make REST API calls across developer-centric features of Zoho CRM like Client Script, Widgets. Invoking CRM APIs, Connection APIs, and external APIs requires different syntax and separate code for each type. ZRC removes this complexity by offering one common and consistent approach to call all APIs, making client-side development easier and faster.

The following are the key features of ZRC.

1. ZRC works with any CRM API version
2. It supports self domain calls by providing only the API endpoint without specifying the domain
3. Uses a single unified syntax for CRM APIs, custom Connections, and external public APIs. 
4. No authentication handling needed for the same CRM org as ZRC manages it automatically
5. Automatic JSON handling without manual parsing.
6. Supports clean async code with full async-await and promise chaining.

2. ZRC Methods

Click here for more details about ZRC Methods.

3. Use Case - Log call notes and update the Lead status with a button click.

At Zylker, Salespersons often make multiple call attempts before connecting with a lead. Manually recording these attempts and updating the Lead status is often overlooked, leading to incomplete tracking and inaccurate pipeline data. To address this, the Admin wants the following changes:

1. Display a popup to capture call attempt details when a button is clicked and save them as a Note on the current Lead.

2. Also, update the Lead_Status of the current Lead to “Contacted” .

4. Solution

Here, the requirement is to create a note based on the Salesperson's description and update the status of the Lead record.To achieve this, Salesperson's input is collected through a pop-up when a custom button is clicked. The ZRC POST method is used to create a note for the Lead. The ZRC PUT method is used to update the status of the Lead record. As the Client Script has to be triggered with a button click, you should create a custom button and add Client Script from "Create Custom Button" pop-up.

1. Go to Setup > Customization > Modules and Fields. Click Leads and navigate to "Buttons" tab.
2. Specify the details about the custom button, Define action as "Client Script" and click Create.
   

1. This opens Client Script IDE.
2. Enter the following script and click Add in Client Script IDE. 
   

1. // Validate if the script is running on a Lead record page
2. if (!leadModule || !leadRecordId || leadModule !== 'Leads') {
3.     ZDK.Client.showMessage('This script is designed to run exclusively on Lead record pages. Please navigate to a Lead record to use this feature.', { type: 'warning' });
4.     return;
5. }
6. 
   
7. // Display a loader to indicate ongoing background operations
8. ZDK.Client.showLoader({ message: 'Logging call attempt and creating follow-up actions...' });
9. 
   
10. try {
11.     // 1. Create a standardized Note attached to the Lead
12.     var notes_content = ZDK.Client.getInput([{
13.         type: 'text',
14.         label: 'Log Call Details'
15.     },
16.     ], 'Log Call Details', 'OK', 'Cancel');
17.     log(notes_content);
18.     console.log({ notes_content });
19.     const notePayload = {
20.         data: [{
21.             Note_Title: 'Call Attempt Log',
22.             Note_Content: notes_content[0],
23.             Parent_Id: { // Associate the note with the current Lead record
24.                 id: leadRecordId,
25.                 name: leadRecordName,
26.                 module: {
27.                     api_name: leadModule
28.                 }
29.             }
30.         }]
31.     };
32. 
    
33.     const noteCreationResponse = await zrc.post('/crm/v8/Notes', notePayload);
34. 
    
35.     // Check for successful note creation (200 OK or 201 Created)
36.     if (noteCreationResponse.status !== 201 && noteCreationResponse.status !== 200) {
37.         throw new Error('Failed to create Note: ' + JSON.stringify(noteCreationResponse.data));
38.     }
39. 
    
40.     // 2. Update the Lead_Status field to “Contacted” on the current Lead
41.     const leadUpdatePayload = {
42.         data: [{
43.             id: $Page.record_id, // Specify the record to update
44.             Status: 'Contacted'
45.         }]
46.     };
47.     const leadUpdateResponse = await zrc.put(`/crm/v8/${leadModule}/${leadRecordId}`, leadUpdatePayload);
48.     $Client.refresh();
49. 
    
50.     // Check for successful lead status update (200 OK or 202 Accepted)
51.     if (leadUpdateResponse.status !== 200 && leadUpdateResponse.status !== 202) {
52.         throw new Error('Failed to update Lead Status: ' + JSON.stringify(leadUpdateResponse.data));
53.     }
54. 
    
55.     // Display a success message
56.     ZDK.Client.showMessage('Call attempt logged, and Lead status updated', { type: 'success' });
57. 
    
58. } catch (error) {
59.     // Log and display an error message if any step fails
60.     console.error('Error executing Log Call Attempt script:', error);
61.     ZDK.Client.showMessage(`An error occurred: ${error.message}`, { type: 'error' });
62. } finally {
63.     // Always hide the loader, regardless of success or failure
64.     ZDK.Client.hideLoader();
65. }

1. In the above script, $Page.module retrieves the current CRM module from which the script is executed.
2. $Page.record_id fetches the unique ID of the record currently opened on the page.
3. $Page.record provides access to the field values of the current record.
4. ZDK.Client.showLoader() displays a visual loading message to inform the Salesperson that background operations are in progress.
5. ZDK.Client.getInput() prompts the Salesperson to enter details about the call through an input dialog.
6. ZRC.post() sends a POST request to Zoho CRM to create a new record and automatically handles authentication and domain resolution.
7. In the notePayload,"Parent_Id" links the created note to the current CRM record and module.
8. ZRC.put() sends a PUT request to Zoho CRM to update an existing record.
9. $Client.refresh() refreshes the current CRM page so the latest updates are immediately visible to the Salesperson.
10. Here is how Client Script works.
    

5. Summary

1. How to update a record in Zoho CRM using ZRC 

2. How to insert a record using ZRC

3. How to reload the page using Client Script.

6. Related Links

1. Client Script related Kaizen posts
2. ZRC Code Samples
   
3. ZRC Documentation
4. Client Script Overview
5. ZDK Documentation
6. Event dictionary
   
   

Previous Kaizen post : Kaizen #225 - Making Query-based Custom Related Lists Actionable with Lookups and Links  | Kaizen Directory

• Topic Participants

• Maadhari M

  

• Sticky Posts

• Announcing the new SKILL.md for Zoho CRM and the updated OAS repository!

  We are introducing a new zoho-crm skill to make working with Zoho CRM Developer tools (like APIs, functions, widgets, client scripts, queries etc) easier and faster, with the help of AI in your preferred AI harness like Claude Code, Codex, Cursor, VSCode

• Kaizen #261 : Using Zoho CRM Skill to generate complex COQL queries

  Hello everyone, In the previous Kaizen posts, we introduced the zoho-crm SKILL.md and discussed how it can help you when you are working with Zoho CRM APIs and Client Script. In this Kaizen, we will focus on using the Zoho CRM `SKILL.md` with GitHub Copilot

• Kaizen #256 - Build an Arrival Readiness Web Tab in Zoho CRM

  Hi everyone! Welcome back to the Kaizen series! In the post, we discuss a use case in hospitality industry: how an Arrival Readiness web tab widget can be used to let reception staff identify and resolve issues before arrival of guests. Use case In the

• Kaizen #198: Using Client Script for Custom Validation in Blueprint

  Nearing 200th Kaizen Post – 1 More to the Big Two-Oh-Oh! Do you have any questions, suggestions, or topics you would like us to cover in future posts? Your insights and suggestions help us shape future content and make this series better for everyone.

• Kaizen #226: Using ZRC in Client Script

  Hello everyone! Welcome to another week of Kaizen. In today's post, lets see what is ZRC (Zoho Request Client) and how we can use ZRC methods in Client Script to get inputs from a Salesperson and update the Lead status with a single button click. In this

• Recent Topics

• Mois de la sensibilisation à la cybersécurité 2026 : faites de la sécurité un réflexe avec Zoho

  Imaginez : vos systèmes informatiques répondent aux normes de sécurité en vigueur et votre entreprise est assurée contre les cyberattaques. Pourtant, un matin, tout bascule. Vos données sont chiffrées et un message glaçant s’affiche à l’écran : « Si vous

• Specifying time increments on a Date/Time field

  Hi all, Im using a Date/Time field in my CRM module. At the moment the increments are 30 minutes. How can I change these to be 15 minutes? Thanks

• Read, View, Access, or Open an OST File Without Outlook

  Have you at any time needed to open an old OST file only to find that Microsoft Outlook is not installed on your computer? It is very annoying, particularly in the case where the file includes important emails, attachments, contacts, or calendar items.

• What's new in Zoho Workplace | August 2026

  Hello Zoho Workplace community! Here's a roundup of all the new features and announcements that went live across Zoho Workplace applications in August. Zoho Mail Zoho Mail is now available in AWS Marketplace! AWS Marketplace users can access and subscribe

• Read, View or Open MBOX File without Any Email Clients

  Since email messages are stored in a single file by MBOX files, they are useful for keeping email data in one location. Many email programmes, such as Thunderbird and other mail clients, support this format. However, if you have an old MBOX file and the

• What's new in Zoho Social - Q3 recap

  Hello everyone, We've rolled out a bunch of exciting updates in Q3, and we're thrilled to walk you through them. Here's a quick look at everything we released in July, August, and September to help you experiment with content, automate engagement workflows,

• The Social Wall: September 2026

  Hello everyone! This month, we’re bringing Snapchat to Zoho Social. You can now connect your Snapchat account and manage your content alongside your other social channels. Whether you want to reach a wider audience through Spotlights or share quick updates

• How to Convert Apple Mac Mail to PST for Outlook for Free?

  Apple Mail is a widely used email program among Mac users, but what do you do if you want to transfer your emails to Microsoft Outlook? In such a situation—for example, when you are moving from a Mac to a Windows computer or when you need to use Outlook

• Turning off the recorded welcome in Zoho Webinar

  Is there a way to turn off the recorded voice that comes up at the beginning of every webinar session? It devalues the experience for attendees from feedback, interrupting their connection with our brand and delaying webinar start unnecessarily.

• Address limits per customer by edition

  I’m on the Standard edition and have reached a limit of 30 addresses under a single customer. Before I move to an annual Professional subscription, I need to confirm the following: What is the maximum number of addresses allowed under one contact, and

• Zoho CRM and Desk sandboxes for testing native integration

  Hello team, We are evaluating the native integration between Zoho CRM and Zoho Desk, We have sandbox instances of both products and want to test the integration there, without any effect on our production CRM or production Desk data. While setting up

• Option to Disable Knowledge Base Section in Feedback Widget Popup Hello Zoho Desk Team

  Hello Zoho Desk Team, How are you? We are actively using Zoho Desk and would like to make more use of the Feedback Widget. One of the ways we implement it is through the popup option. At the moment, the popup always displays the Knowledge Base section,

• Losing description after merging tickets

  Hello, We merge tickets when they are about the same topic from the same client. It happens sometimes. We recently noticed that after the merger only the description from the master ticket is left in a thread. And the slave-ticket description is erased.

• Outgoing Mail Blocked – Suspicious Login Activity (Need Clarification and Solution)

  Hello, I’m currently facing an issue where my Zoho Mail account has been blocked due to “suspicious login activity,” and outgoing emails are restricted. Here are the details shown: Block type: Outgoing mail blocked Reason: Suspicious login activity A

• Account Blocked due to Suspicious Activity.

  Hello, Trying to get access to my account, I have found this message above in the subject of this message. I am unable to log back to my account (see err. mess. below.) and thus cannot get rif of this following the Zoho procedure : I followed the step

• Zoho Recruit mailserver get blocked by Microsoft!

  Hi, We have experienced this issue twice now, where Zoho Recruit outbound IP addresses are being blocked by Microsoft. We are confident that Microsoft is the blocking party, as all outbound emails to candidates with @hotmail.com, @live.com, and @outlook.com

• Months of WooCommerce–Zoho Inventory sync failures and repeated support requests – has anyone experienced this?

  Months of WooCommerce–Zoho Inventory sync failures and repeated support requests – has anyone experienced this? I run a small retail business using WooCommerce and Zoho One. For months, I have been trying to resolve recurring synchronisation failures

• Name autocomplete

  Hi, During searching emails the web tool does not always propose the auto-completion of the saved emails. As a result I either have to go to contacts and look up the exact email, or the exact full name including the middle name and any dots, which is

• How to Manage Two GST Numbers / Two Companies in a Single Zoho Inventory Organization?

  Hi Team, We currently have two separate legal entities: A Proprietorship Firm with its own GSTIN A Private Limited Company with a different GSTIN However, operationally, both companies deal with the same products, and we would like to manage the physical

• View Cannot Use UPC as Criteria

  When creating a new custom view, the UPC field is not available as a criterion for the view. This seems strange, because both ISBN and EAN are available in the dropdown. Because of this, I feel like the situation is possibly an oversight rather than by

• How To Implement an Auto-Check-out Feature for Attendance?

  If an employee forgets to check out, the system should automatically check out the employee at 6:30 PM

• Enhanced Zoho CRM and Office 365 calendar synchronization features!

  Dear customers, We're excited to share some significant improvements to our Office 365 calendar synchronization features, aimed at providing you with more control and a more personalized experience. What’s new Choose your Office 365 calendar: During the

• What are the best practices for managing tax records and financial information for a small business?

  I’m interested in learning how other small business owners and accounting professionals organize their financial records and prepare for tax filing. With bookkeeping, expense tracking, income records, and tax documents all needing to stay accurate, having

• How to add a fee based on payment method

  I currently accept both ACH payments and credit card. I want to add a 3% fee to a number of my subscription plans if the customer chooses to use a credit card (and not ACH/checking). How do I do this? Is there an in-built feature, or would i have to create

• How to Open Google Takeout and Thunderbird MBOX Files?

  MBOX files are used by email clients and services, such as Google Takeout and Mozilla Thunderbird, to store email messages. It can, however, be difficult to open such files if you don't have an email programme that is compatible. Google Takeout enables

• Convert MBOX to PDF Free on Mac and Windows

  MBOX files are widely used for storing email messages in email clients such as Thunderbird, Apple Mail, and other programs that support the MBOX format. Although this format is useful for handling emails, it can at times be inconvenient to access the

• Cannot apply tags to multiple items at once

  It is very frustrating needing to apply tags to notes individually. Even worse that it takes multiple clicks to do it. Can there please be an update to: 1.) Allow us to apply tags to batches of notes in one go. 2.) Make it less clicks to add a tag 3.)

• Automating CRM backup storage?

  Hi there, We've recently set up automatic backups for our Zoho CRM account. We were hoping that the backup functionality would not require any manual work on our end, but it seems that we are always required to download the backups ourselves, store them,

• not able to convert pdf to jpg and other forms and vice versa.

  i want to change my pdf to jpg, word, etc and some times jpg to pdf. i don't know how to do in this.

• Indeed has retired Organic (Free) job posting support for Staffing Agency edition users

  Dear Zoho Recruit Users, Due to a policy change by Indeed, Organic Job Posting support for staffing agencies is no longer be available in all regions, except Japan. Keep in mind that Corporate HR edition accounts will not be impacted by this change in

• Changing an existing item to different accounts & inventory-tracked

  Hi everyone, I have an item in Zoho Books that was originally set up as a non-inventory item. Over time, I associated it with different sales and purchase accounts, and I now have many invoices, bills, and reports that use this item. My business process

• How to Convert Emails to PDF Format in Batch

  It is helpful to convert emails into PDF format when you want to save important messages, when you need to share business correspondence, or when you wish to keep email records for future reference. PDF files can be readily opened, printed, and shared

• Function #24: Automatically display deal name from Zoho CRM on quotes in Zoho Books

  Deals allow businesses to organize and visualize their sales pipeline. This provides a clear overview of all potential opportunities and helps in making informed decisions. Zoho CRM empowers you to create deals or potentials for your clients and monitor

• Lookups and Custom Modules

  I created a Custom Module that I'm calling "Item Purchasing Group". This module will store information for groups of Items that must be purchased together (including minimum overall quantities and/or values, etc.). This will have a one-to-many relationship

• Zoho Books | Product updates | October 2026

  Hello users, October brings a range of new features and enhancements to Zoho Books, designed to simplify compliance, streamline accounting workflows, and improve inventory management. From the launch of the Nigeria Edition and France’s e-invoicing capabilities

• Create custom rollup summary fields in Zoho CRM

  Hello everyone, In Zoho CRM, rollup summary fields have been essential tools for summarizing data across related records and enabling users to gain quick insights without having to jump across modules. Previously, only predefined summary functions were

• Button or Links order

  Is there a way to re-order the buttons or links that are created? Moderation Update: With our recent enhancement to custom button creation from the layout editor, administrators can now reorder custom buttons directly from the layout editor, and this

• Zoho Books | Product updates | August 2026

  Hello users, July has been an exciting month for Zoho Books! This month, we're excited to introduce HTML PDF Templates, Placeholders as Pills, expanded approval workflows for Sales Returns and Journals, and significant compliance updates across the India,

• Bulk updating tags

  My organisation handles a number of restricted funds. We previously did this by having a chart of accounts where each restricted fund has its own income and expense accounts. However, our accountant changed this, moving all transactions into accounts

• Download or Backup Bulk Emails from IMAP Server

  Taking email messages from an IMAP server and saving them is a wise method for ensuring that important emails are kept safe and easy to access. No matter whether you have a business email address or a personal mailbox, keeping a local copy of your emails

• Next Page