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

• 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.

• 【Zoho CRM】作業リスト機能リリースのお知らせ

  ユーザーの皆さま、こんにちは。コミュニティチームの藤澤です。 今回は「Zoho CRM アップデート情報」の中から、作業リスト機能リリースのお知らせ情報をご紹介します。 目次 作業リスト機能　概要 機能①　自分の未完了の活動 機能②　処理待ち 機能③　自分の作業リスト 作業リスト機能　概要 営業チームでは、CRM内に業務やデータが分散しているため、管理が煩雑になりがちです。この断片化は、機会の見逃しや生産性の低下につながります。 作業リスト機能は、タブを横断する業務項目をひとつのカスタマイズ可能なダッシュボードに集約し、業務を効率的に管理できるようにします。

• SalesIQとPageSenseの利用について

  初めての投稿で場違いだったらすいません。 弊社ではSalesIQを運用しているのですが、追加でPageSenseの導入もしたいと現場からの声があります。 両サービスともクッキー同意バナーが必要なサービスなのですが 弊社では同意無しに情報はとりませんという方針なので 2つ入れると2つバナーを出す必要がでてきます・・・ 両サービスを運用されてる方があれば運用状況とか教えてほしいです。 PageSenseについては詳細まで機能を理解してないなかでの質問です。

• Parent-Child Tickets using API or Deluge

  Hi Everyone, We are looking at the parent-child ticketing features in Zoho Desk. We want to be able to create a parent ticket at customer level and nest child tickets underneath. The issue we are facing is to be able to automate this. I'm checking the

• Closing connected ticket after closing WA conversation

  Hi, At the moment, once someone sends a message to our WA number, a corresponding ticket is automatically created. After the question is answered, our support department closes the chat/conversation. However, after that, the connected ticket is still

• Note sync turn off

  Hi, Is it possible to turn off notes sync between task notes and the parent module? (Account/Deal)

• Basic Plan Active but Survey Creation Still Limited to 3 Surveys

  I have an active Basic (Monthly) subscription (valid period: Dec 24, 2025 – Jan 24, 2026), but the system still limits survey creation to only 3 surveys, which matches Free plan behavior. The subscription appears active in Portal Information, however

• 2025 in Review: Powering Field Services Forward—One Feature at a Time

  As 2025 draws to a close, it’s time to pause and reflect on a year of meaningful progress at Zoho FSM. This year was all about listening closely to our customers and partners, building with purpose, and continuously improving the way field service teams

• API Support for Creating Invoices with Batch-Tracked Items

  Hi Zoho Community, I am working on an integration where we create invoices in ERPNext and push them to Zoho Books. I need to send batch-tracked items (batch numbers) when creating invoices. I could not find any reference in the Zoho Books API documentation.

• New to automation - please help

  Hi there! We are new to automations in Zoho. We built out one automation campaign and it seems to be firing off for some people but others not. Please advise what's the best practice or if anything we should tweak. Thank you so much!

• Unable to Create Zoho Booking via the Book Appointment API

  Its giving the below error {     "response": {         "errormessage": "Error setting value for the variable:customer_details\n null",         "status": "Error"     } } Request: POST Url: https://www.zohoapis.in/bookings/v1/json/appointment attached Zoho-oauthtoken

• Task Details on task template

  When creating a task template in settings that task details seem to be missing. Is it not possible to set the details of a task, such as the priority, type, reminder settings, and custom field values?

• Building Toppings #3 -Testing and publishing Bigin toppings

  Hey Biginners! In previous forum posts, we discussed what a Bigin topping is and explored the Bigin Developer Console's features. In this post, we're going to create a topping from scratch and discuss how to test and publish it. Our topping will automate

• markdown files?

  How can I import a markdown file into a note?

• Mail to Zoho Notebook

  In the Instuctiosn I faound as email add@notebook.app In my account I see add@eu.notebook.app What is correct please

• Auto-Invite Users to Portals in Zoho CRM based on Conditions

  Hello Everyone, You can now automate portal invitations in Zoho CRM with the new Auto-Invite users feature in Portal management. No more manually enabling portal access one by one. With this enhancement, you can automatically send invites for users to

• Growth You can Count On: Zoho Billing's 2025 Journey

  As we wrap up 2025, we’re reflecting on a year rooted in steady progress and meaningful growth for Zoho Billing. Every enhancement we have introduced was built to support scalable and reliable billing growth for your business. From launching the Enterprise

• Need help with creating workflow with Bigin and Clickup

  Can you please help me with this? I am trying to create a workflow in Zoho Flow wherein a bigin Pipeline deal moves to Decision Closing, it will create a task and subtasks in Clickup, under the condition/filter that the Deal name contains the word Social

• [Webinar] Automate generation of wills, trusts, POAs, and other estate planning documents with Zoho Writer

  Managing the lifecycle of the estate planning documents such as wills, trusts, and POAs, from client intake to final storage, can be complex and time-consuming. Join our live webinar to learn how Zoho Writer transforms this process by automating document

• Create / Update Rule in TeamInbox when record is updated in ZohoCRM using flow?

  I'm currently evaluating options and trying to work out if the possible scenario is possible; If a record in ZohoCRM is updated, take 2 of the fields from that - lets call them 'OrderRef' and 'OrderTo'. Using flow, if a record is added or updated, add

• Plans to allow more columns of monitoring, and monitoring not only your own channels?

  Are their any plans to allow more columns of monitoring, and monitoring not only your own channels? Here's why - I'm sure I'm not alone in that we sell other brands products, so not only am I interested in my own brand social channels, but also the social

• Unwrapping the best practices for the Zoho Desk mobile app: Part 1

  In focus: Empowering the field and frontline customer support representatives Imagine having to carry your computer everywhere to respond to customers, handle escalations, and update your process. This series presents you with efficient tips to handle

• dealing with post dated cheques

  Hi, can you help me please the best way to deal with this We sell an item of three months duration that is paid for with post dated cheques in monthly stages example - item is sold £3000 Cheque 1 is for £1000 due at time of sale (say Sept) cheque 2 is dated 25th of next month (Oct) cheque 3 is dated 25th of next month +1 (Nov) Now, with invoice number one it's simple - i send a standard invoice as usual But with the other two here's what i want zoho to do next month i want it to send an invoice on

• Is there a way to sell in a practical method multiple subscriptions of the same product? i.e. domain names

  In evaluating Zoho Billing, a hurdle to adopting it is that Zoho Billing does not seem designed to support businesses that sell multiple subscriptions of the same product. In our case, we need to sell and manage several domain names per client. Am I right

• Paid Support Plans with Automated Billing

  We (like many others, I'm sure) are designing or have paid support plans. Our design involves a given number of support hours in each plan. Here are my questions: 1) Are there any plans to add time-based plans in the Zoho Desk Support Plans feature? The

• Bug Report: "Name A-Z" sorting fails when Note titles start with an Emoji

  Hello, I recently migrated from Evernote (~2600 notes across 23 notebooks). I use emojis at the start of my note titles for visual organization. The Issue: When I set the view to Sort by: Name (A to Z), the sorting logic breaks for any note starting with

• Copy & Paste not working

  I could create and save 10 new documents but when I go to copy and paste content (just text) into them, only 1 of 10 would save the content. It would appear to save the content but when I go back into the documents, they are empty.

• Currency for Petty Cash

  Currencies for Petty Cash should be available

• editing/applying online payments

  We have customers who pay part or all of an invoice and then cancel their service and want the payment as a credit to future work. It would be ideal if we could make it an excess payment and then void the invoice. I can't make it an excess payment because

• Contacts per department

  Hello, Is it possible to limit Contacts to a Department? Thanks

• This site can’t be reached mail.zoho.com took too long to respond

  In my office at any system, we couldnt able to login zoho email. it shows " This site can’t be reached mail.zoho.com took too long to respond". please fix it soon.

• Can send email from zoho mail, but can't receive any.

  Hi, My domain is sattvameditationresort.com. I've updated MX records with those of Zoho. But i can't send any mails to this email id from gmail. I have checked the MX status with MXTOOLS, its showing the correct entry either. The error is as shown below:

• My domain did not activate

  Hi, my domain (apsaindustrial.com.ar) did not activate, and the phone verification message never arrived. Please would you solve this problem? Thanks.

• Host not found?

  Howdy! So i'm trying to add my custom domain for with the mail server. I have 100% control of my DNS and have tried every single option (TXT, CNAME, and even HTML) multiple times, ensuring i did it properly, to no luck. I get the same error message every

• Emails are going to notification folder and not in inbox

  emails are going to notification folder and not into inbox

• Error AS101 when adding new email alias

  Hi, I am trying to add apple@(mydomain).com The error AS101 is shown while I try to add the alias.

• Auto End Chats After Customer Inactivity

  Hello Everyone, I may be missing something, but is there a way to auto-end chats when a customer has been inactive for an amount of time? I have several operators (we use a shared set of account with schedules for people... that's another story) but at

• Report on opportunities showing only the last note added.

  Hi I need to create a report that shows the most recent note added to each opportunity. This is so management can see what the latest update is according to the assigned salesperson. One workaround is to use the status field but this implies added manual work and mistakes as the salesperson would have to copy the existing status to a note before adding the latest status... otherwise the activity history would be lost. My current workaround is a report on Notes with Opportunities as the related module.

• Please add Zelle as an online payment option

  Hello, I would like to request Zelle be added to the online payment service providers for Zoho Invoice. Considering how ubiquitous Zelle has become as a way to pay people via the major banking institutions, I feel like many freelancers would benefit from

• This user is not allowed to add in Zoho. Please contact support-as@zohocorp.com for further details

  Hello, Just signed up to ZOHO on a friend's recommendation. Got the TXT part (verified my domain), but whenever I try to add ANY user, I get the error: This user is not allowed to add in Zoho. Please contact support-as@zohocorp.com for further details I have emailed as well and writing here as well because when I searched, I saw many people faced the same issue and instead of email, they got a faster response here. My domain is: raisingreaderspk . com Hope this can be resolved.  Thank you

• Next Page