Kaizen #127 - Circuits in Zoho CRM - Part 2

Hello everyone!

We're back with part 2 of Circuits in Zoho CRM!

We are as excited as you are with this topic! Let's dive right in!

As promised, in today's post, we will discuss a use case, see how execution happens, and associate that circuit with a workflow.

In our next post(Yes! There's going to be another one!), we will associate the circuit with a button and a blueprint, view logs, and debug issues.

Sample use case - Loan Verification Process

Consider that we have a module in CRM called Customers, where we have personal information of customers, tax-related details, tax and personal ID verification details and status. Our aim is to check the requested loan amount, check eligibility, and then grant or reject it.

Here is a screenshot of a record in the Customers module.

Our condition is that whenever the loan amount is less than Rs. 500,000, the circuit should directly proceed to document verification. When the requested loan amount is greater than Rs. 500,000, we must check a few eligibility criteria before proceeding to document verification.

We can automate this entire process using Circuits, and execute it through a button, associate it with a workflow or a blueprint.

Let's take a look at the Circuit's flow.

Here are the different states of the Circuit that explain the logic.

1. Get the loan record.
2. Check the loan amount.
   
3. If the loan amount is less than Rs. 500,000, proceed to document verification.
   
4. If the loan amount is greater than Rs. 500,000, check the tax filing status.
   
5. If tax is not filed, update the record's Loan Eligibility field with the value "Tax not filed. Hence, not eligible for loan".
   
6. If tax is filed, fetch the applicant's credit score and check the eligibility.
   
7. If the credit score falls short, update the record's Loan Eligibility field with the value "Issue with credit score".
   
8. If the credit score is up to the mark, proceed to document verification—Personal ID and Tax ID verification.
   
9. Update the details of the record to sanction the requested loan.
   

Let's discuss each of these states in detail.

1. Get the loan record

Builder View

Type: Get Record from Zoho CRM's states.

Action: Gets the details of the loan record from the Customers module. The output is in the following format.

{     "ZohoCRM": {         "record_id": "5575270000005762031",         "user_id": "5575270000005379053",         "module": {             "api_name": "Customers",             "tab_label": "Customers",             "id": "5575270000001975002"         }     },     "record": {         "data": [             {                 "Owner": {                     "name": "Patricia Boyle",                     "id": "5575270000001947001",                     "email": "p.boyle@zylker.com"                 },                 "$currency_symbol": "$",                 "Tax_ID_Verification_Message": "Tax ID Verified Successfully",                 "$review_process": {                     "approve": false,                     "reject": false,                     "resubmit": false                 },                 "$sharing_permission": "full_access",                 "Personal_ID_Number": "464694660655",                 "Personal_ID_Verification_Message": "Personal ID Verified Successfully",                 "Name": "Stephen Adams",                 "Manual_Approval": "Depends on score",                 "$state": "save",                 "$process_flow": false,                 "Tax_Score_Status": "Score is eligible for Loan",                 "$locked_for_me": false,                 "Tax_ID_Number": "GBHPS3618H",                 "id": "5575270000005762031",                 "Tax_ID_Verified_Date": "2024-02-26",                 "Loan_Eligibility": "Eligible for Loan",                 "$approval": {                     "delegate": false,                     "approve": false,                     "reject": false,                     "resubmit": false                 },                 "Modified_Time": "2024-02-29T12:26:11+05:30",                 "Tax_ID_Verification_Status": "Verified",                 "Tax_Return_Availability": "Yes",                 "Tax_ID_Verified_Time": "2024-02-26 23:28:39.0",                 "Personal_ID_Verified_Time": "2024-02-26 23:28:39.0",                 "Created_Time": "2024-02-29T12:26:11+05:30",                 "Amount": 600000,                 "$editable": true,                 "Personal_ID_Reference": "6cefa3d4-b87b-46a6-8814-b21fb422a28d",                 "$orchestration": false,                 "Tax_ID_Reference": "f6697aa8-8efc-4ee9-8dcc-0bc838755cb4",                 "Tax_Score": 450,                 "Personal_ID_Verification_Status": "Verified",                 "Personal_ID_Verified_Date": "2024-02-26",                 "$in_merge": false,                 "Locked__s": false,                 "Tag": [],                 "$zia_owner_assignment": "owner_recommendation_unavailable",                 "$approval_state": "approved",                 "$pathfinder": false             }         ]     } }

You can use any part of this output as input to other states. You can achieve this by using the JSON Path expression in the “result path” to traverse the result JSON of the state.

Result path allows you to combine state result with state input to pass as output. You can add the result path in the "Input/Output" section in the Builder view as well as the JSON in Code view.

In our case, we want to use the data inside the “record” JSON object. So, the result path will be $.record.

Result path is mandatory when you use the Get Record Zoho CRM state.

Next state: Check Loan Amount

Code View

2. Check Loan Amount

Builder View

Type: Branch

Action: Checks for the condition specified in the branch—check if the loan amount < 500,000. If yes, and Go to Documents verification state, else go to Check tax filing status state.

Next state: Check Tax filing status(if loan amount > 500,000)

Code View

3. Check Tax Filing Status

Builder View

Type: Branch

Action: Checks for the condition specified in the branch—if the tax filing status is Yes, fetch the credit score. Else, update the record with "Tax not filed; not eligible for loan".

Next state: Fetch Applicant Credit Score

4. Fetch Applicant Credit Score

Builder View

Type: Function

Action: Executes the CRM function "Tax Score Check" that holds the logic to get the basic eligibility stored in the Org variable "eligibility", compare it with the tax score of the applicant, and update the record, accordingly. Here is the snippet of this function.

Next state: Check eligibility of Credit Score

Code View

5. Check eligibility of Credit Score

Builder View

Type: Branch

Action: Checks for multiple conditions—if Tax Score Status = Eligible, go to Document Verification.

If Tax Score Status = Not eligible & the value of the field "Manual Approval" = "Not approved", update the record with "Issue in Tax Score".

If Tax Score Status = Not Eligible & "Manual Approval" = "Approved", proceed to document verification.

Next state: Depends on the condition that is met in the "Check Tax Score Eligibility" state.

Code View

6. Documents Verification Process

Builder View

Type: Parallel

Action: Verifies the Tax ID and Personal ID of the applicant.

Next state: Verification Details - Update Record

Code View

7. Tax ID Verification

Builder View

Type: Function

Action: Executes the function "Tax ID Verification" that has the logic to verify the tax details of the applicant.

Here is the snippet of this function.

Next state: Verification Details - Update Record

Code View

8. Personal ID Verification

Builder View

Type: Function

Action: Executes the function "Personal ID Verification" that has the logic to check for the applicant's personal details.

Here is how the function looks.

Next state: Verification Details - Update Record

Code View

9. Verification Details - Update Record

Builder View

Type: Function

Action: Executes the function "Update Customer Record status" that uses the Deluge Update Record integration task to update the "Loan eligibility" field.

Here is how the function looks.

Next state: End

Code View

10. Update Record - Tax Not Filed, Not Eligible

Builder View

Input/Output

Type: Function

Action: When the requested loan is greater than Rs.500,000 and the Tax Filing Status in "Not Filed", this state executes the function "Update Customer Record status". This function uses the Deluge Update Record integration task to update the "Loan eligibility" field, and takes the parameters "rec_id" and "loan_eligibility" with the values "$.ZohoCRM.record_id" and "Tax Filing is missing, Hence not eligible for the loan.", respectively.

Next state: End

Code View

11. Update Record - Issue with Credit Score

Builder View

Type: Pass

Action: When the tax score eligibility does not meet the requirement, this state ends the circuit's execution.

Next state: End

Code View

Testing and Execution

Let us see the execution of this circuit with a sample record ID.

When you click each state, you can see the input and output of that state.

When you click "View Logs", you can see how execution has happened, the payload for each state, the response, etc.

Associating this Circuit with a Workflow

Follow the steps mentioned in this article to create a workflow.

The condition for this workflow to execute the circuit is when the requested loan is greater than Rs. 500,000.

The Action is to execute the circuit. Choose the option "Execute Circuit" from the Instant Actions and select the Verification Process Circuit.

Save the workflow.

Let's test this workflow by creating a record in the Customers module with the loan amount less than Rs. 500,000.

As you can see, the workflow is triggered and executes the circuit when the loan amount is less than Rs. 500,000.

You can view the circuit's execution and other details as a related list.

Summary

Circuits allow you to automate entire business processes by allowing you to orchestrate functions along with your business logic as you see fit.

As you witnessed in this example, we used multiple independent functions written in CRM to achieve our business case through utilizing them in a circuit. This gives you the benefit of writing functions that can be reused in multiple places while saving you from the grief of dealing with huge volumes of code that are hard to maintain and harder to debug when written as a single function.

We hope you liked this post. We'll see you next week with another post on Circuits.

Let us know if you have any questions or feedback. We are listening!

Cheers!

Shylaja S

Additional Reading:

Kaizen #126 - Circuits in Zoho CRM - Part 1

Kaizen series

Circuits Help Documentation

• Topic Participants

• Shylaja S

  

• Sticky Posts

• 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

• Kaizen #222 - Client Script Support for Notes Related List

  Hello everyone! Welcome to another week of Kaizen. The final Kaizen post of the year 2025 is here! With the new Client Script support for the Notes Related List, you can validate, enrich, and manage notes across modules. In this post, we’ll explore how

• Kaizen #217 - Actions APIs : Tasks

  Welcome to another week of Kaizen! In last week's post we discussed Email Notifications APIs which act as the link between your Workflow automations and you. We have discussed how Zylker Cloud Services uses Email Notifications API in their custom dashboard.

• Kaizen #216 - Actions APIs : Email Notifications

  Welcome to another week of Kaizen! For the last three weeks, we have been discussing Zylker's workflows. We successfully updated a dormant workflow, built a new one from the ground up and more. But our work is not finished—these automated processes are

• Kaizen #152 - Client Script Support for the new Canvas Record Forms

  Hello everyone! Have you ever wanted to trigger actions on click of a canvas button, icon, or text mandatory forms in Create/Edit and Clone Pages? Have you ever wanted to control how elements behave on the new Canvas Record Forms? This can be achieved

• Recent Topics

• Custom Related List Inside Zoho Books

  Hello, We can create the Related list inside the zoho books by the deluge code, I am sharing the reference code Please have a look may be it will help you. //..........Get Org Details organizationID = organization.get("organization_id"); Recordid = cm_g_a_data.get("module_record_id");

• Migrate different zoho subscription to zoho one

  Dear We have different zoho subscription we need to migrate it to zoho one. Currently we are paying for zoho email, zoho expense, zoho payroll etc under different admin We need to move it too zoho one flexlible plan for all my employees

• Features, Feedback and Votes

  We’re launching the Feedback Forum for our customers. This is 'THE' place where you can add everything you’d like to see in Zoho Books. If you don't find the specific feature you need, simply add it so others can also vote for it. While we cannot promise

• Payment system for donations management

  I manage an organization where we receive donations from payers. Hence, there is no need to first create invoices and then create payments received against the invoices. What are the recommended best practices to do this in ZohoBooks?

• There Might Be A Glitch in Determining If A String Represents A URL

  I suspect there might be a glitch in determining if a string represents a URL or not. For example, I cannot embed the following URL. Perhaps the exclamation mark or parentheses are the culprit? https://en.wikipedia.org/wiki/How_the_Grinch_Stole_Chri

• Customer Management: #4 Enhance Customer Journey

  When Neha started DefineOps, a growing IT support and consulting firm, most of her work was straightforward. A client would sign up for a free version, decide whether the service works for them, and then either continue or discontinue. Billing was simple,

• Android app sync problem - multiple devices have same problem

  Hello, I am having a problem with synchronization in the Android app. When I create a drawing, the data does not sync correctly—only a blank note is created without the drawing. I tested this on multiple devices, including phones and tablets, and the

• Marketing Tip #1: Optimize item titles for SEO

  Your item title is the first thing both Google and shoppers notice. Instead of a generic “Leather Bag,” go for something detailed like “Handcrafted Leather Laptop Bag – Durable & Stylish.” This helps your items rank better in search results and instantly

• Territory Assignment Issues (Lead to Account + Contact)

  1. Lead → Account & Contact Territory Assignment on Conversion A Lead is automatically assigned one or more territories using a workflow and Lead Assignment Rules. This works as expected, and we are able to assign multiple territories to a Lead automatically.

• Marketer's Space: Proven tips to improve open rates – Part II

  Hello Marketers! Welcome back to another post in Marketer's Space! We're continuing from where we left off a fortnight ago. We ended the previous post discussing the subject line, and we'll continue from there. Let's dive right in. Pre-header Pre-header

• SQL Table slowed to a crawl

  Hi all - I seem to have noticed an update. Now whenever I am typing in the script field for the SQL tables there is a huge delay and it is all very slow. This has never been the case for me in over 5 years of using Analytics - I really hope it's fixed

• Deluge Events/search API works in user environment but not in sandbox – why?

  I am creating an Extension for Zoho CRM using Zoho Sigma Platform I’m using the following Deluge code to search Events in Zoho CRM based on Start_DateTime: criteria = "(Start_DateTime:greater_than:2025-12-20T00:00:00+00:00)"; url = "crm/v8/Events/search?criteria="

• Ensure Consistent Service Delivery with Comprehensive Job Sheets

  We are elated to announce that one of the most requested features is now live: Job Sheets. They are customizable, reusable forms that serve as a checklist for the services that technicians need to carry out and as a tool for data collection. While on

• What are Zoho Meeting capabilities included in Zoho Workplace Standard?

  I am evaluating using Zoho Meeting for my organization, but it is not clear what Zoho Meeting capabilities are already included in Zoho Workplace Standard. - Are meeting recordings included in Workplace Standard? - Can we invite external meeting participants

• How can I get the participant list of a reoccurring meeting afterwards?

  I'm trying to use the Meeting Participant Report from the API docs but when I call it on a reoccurring meeting it returns that there are no participants because it thinks I'm talking about the meeting in the future. Is there a way to use webhooks or some

• Function #50: Send Mass emails to your customers

  Hello everyone, and welcome back to our series! We have reached a milestone of 50 Functions, which means that we have automated 50 different tasks in Zoho Books. Every Friday, we have shared a nifty function aimed at either automating a task or streamlining

• Full Hebrew Language Support for Client-Side Zoho Assist Interface

  Dear Zoho Assist Team, We would like to request an enhancement to Zoho Assist's client-side interface to support full Hebrew language customization, including all popups, notifications, and session-related messages. Current Limitation The Join page allows

• Add Hebrew & RTL Support to Feedback Widget

  Hello Zoho Desk Team, How are you? We are using Zoho Desk and would like to utilize the Feedback Widget. While Zoho Desk itself supports Hebrew and RTL, the Feedback Widget unfortunately does not. We kindly request that Hebrew and full RTL support be

• Merge Tickets Directly from Contact Page in Zoho Desk

  Dear Zoho Desk Support Team, We are writing to request a new feature that would allow users to easily merge tickets directly from the contact page in Zoho Desk. Currently, the only option to merge tickets is from the Tickets list view page, which can

• Different languages for users

  Hello, Do you plan to enable individual users to select their languages for interface? Currently language can be changed for everyone - it looks like a settings for a whole portal, which is not good when you are working internationally. Best regards,

• Kaizen #222 - Client Script Support for Notes Related List

  Hello everyone! Welcome to another week of Kaizen. The final Kaizen post of the year 2025 is here! With the new Client Script support for the Notes Related List, you can validate, enrich, and manage notes across modules. In this post, we’ll explore how

• 2025年 Zoho コミュニティ 活動の振り返り 🎉

  ユーザーの皆さん、こんにちは！コミュニティチームの中野です。 2025年も多くの学びと出会いがあったZoho コミュニティ。 本記事では今年の活動を振り返りながら、フォーラムの投稿・参加者の皆さん・イベントのハイライトをご紹介していきます。 目次 フォーラム：注目の投稿 フォーラム：多くの貢献をしてくださった方々 ユーザー交流会振り返り ワークアウト振り返り その他のトピックス 1. フォーラム：注目の投稿 本フォーラムでは様々な議論と知識の共有が行われました。 ユーザーの皆さんが日々の業務で直面する課題を投稿し、経験豊富なユーザーさん達が実践的な解決策を提供してくださいました。

• Customer Management: #3 Giving Customers Control & Privilege

  Rio, the founder of RenoTech Solutions, a fast-growing digital service company, found itself juggling a dozen different services for its clients. They handled one-time setup fees, recurring monthly invoices, and custom milestone-based billing for projects.

• Can I use a Standalone CRM Function as the Callback URL For Async Export Data API?

  I am creating an export job using this API https://www.zoho.com/analytics/api/v2/bulk-api/export-data-async/create-export/view-id.html There is a "callbackUrl" key in the CONFIG object. I tried copying the URL for a standalone function in CRM which can

• Add RTL (Right-to-Left) Text Direction Support Across All Zoho Learn Editing Interfaces

  Hi Zoho Learn Team, Hope you're doing well. We would like to request an important enhancement to Zoho Learn regarding support for right-to-left (RTL) languages such as Hebrew and Arabic. 🔹 Current Issue While the Knowledge Base Article editor provides

• Add Hebrew Support for Meeting Transcripts Provided by ZIA in Zoho Cliq

  Hi Zoho Cliq Team, Hope you're doing well. We would like to request the addition of Hebrew language support for the Meeting Transcript and Summary feature in Zoho Cliq. Currently the transcript and summary feature is available for recorded meetings and

• Remote Control Functionality During Screen Sharing in Zoho Cliq

  Hello Zoho Cliq Team, We would like to request the addition of remote control functionality during screen sharing sessions in Zoho Cliq. Currently, while screen sharing in Cliq is very useful, it lacks the ability for another participant to take control

• Centralized Organization Information Management in Zoho One

  Dear Zoho One Support, I'm writing to propose a feature that would significantly improve the user experience and streamline data management within Zoho One. Current Challenge: Currently, managing organization information across various Zoho One apps requires

• Enhance Zoho One Conditional Assignment to Fully Reassign App Settings When Changing Departments

  Hi Zoho Team, We’d like to submit a feature request regarding the current behavior of Zoho One’s conditional assignment logic when moving a user between departments. 🔧 Current Limitation As it stands, Zoho One’s conditional assignment does not remove

• Ability to Filter Alias Mailboxes in Zoho Recruit

  Dear Zoho Recruit Team, I hope you are doing well. We would like to request a feature enhancement regarding the handling of alias mailboxes in Zoho Recruit. Currently, when we connect an alias mailbox (e.g., jobs@domain.com) from our Zoho One account

• Automatic Department and Employee Sync Between Zoho One and Zoho People

  Dear Zoho Support, I'm writing to propose a valuable feature request that would streamline data management and improve user experience within the Zoho ecosystem: automatic synchronization between departments and employees in Zoho One and Zoho People.

• Prefered Bin Missing in android APP

  Andoroid app dosent show preferred bin in the picklist. The workaround support reccomend is to use the computre to create the picklist. it shuld be information to be shown aas basic for the pciker.

• Open Sans Font in Zoho Books is not Open Sans.

  Font choice in customising PDF Templates is very limited, we cannot upload custom fonts, and to make things worse, the font names are not accurate. I selected Open Sans, and thought the system was bugging, but no, Open Sans is not Open Sans. The real

• Function #1: Convert an accepted Estimate to Sales Order automatically in Zoho Books

  As you’re aware, Zoho Books provides a default option to have the estimates automatically converted to invoices once your customer accepts them. Many of you wanted a similar option for sales orders, so here’s a workflow that converts accepted estimates

• Reusable Jira Connection for Multiple Zoho Projects Imports

  Hello Zoho Projects Team, We would like to raise a concern and submit a feature request regarding the Jira → Zoho Projects migration process, specifically around how Jira connections are handled. Current Behavior: When setting up a Jira connection for

• Zoho invoice doesn't support Arabic language

  I added a clause in the terms & conditions section in Arabic but it doesn't appear when I sent or print it.

• Recurring Invoice Placeholder Not Updating Billing Period

  Hi, I’m using Zoho Invoice Free and want the billing period to update automatically in recurring invoices. In Item Description I tried: Billing Period: %(m-6)% %(y)% to %(m-1)% %(y)% but even if the invoice date is in 2026, it still shows the period based

• Related list Mobile Device

  Hello, We use an the Zoho creator application to make reports linked to Accounts. On the computer: it's easy to go the Account and see all the created reports in the related list below On iPad/Phone ZOHO CRM APP: we cannot see the reports on those accounts

• Can't update the company address in zoho invoice

  Dear Sir/Madam, I want to update the company address in Zoho Invoice but failed. It popped out a sentence "Invalid value passed for Website". Please advice how to solve this problem. Thank you.

• Is there a plan to allow for the hierarchical organization of Customers / Companies in Zoho Billing?

  We have a few customers who have organizational structures that we haven't quite found a way to deal with in Zoho Billing. In CRM, these sub-companies (or subsidiaries or whatever you want to call them) all have another CRM account as the parent account.

• Next Page