Visualizing Blueprint Transition Criteria Using Zoho CRM REST API Queries

Visualizing Blueprint Transition Criteria Using Zoho CRM REST API Queries



Hello Everyone,

Welcome back to another edition of the Kaizen series, where we uncover powerful ways to extend and customize Zoho CRM.

Have you ever asked , "Why can't I see the blueprint transition button on this record, why it failed, and how can I know whether the criteria is nested or not?". And the Admin answered: "Hold on, let me open the Blueprint setup and check the criteria", only to spend the next ten minutes navigating through setup, finding the transition, and decoding a wall of flat conditions with no visible AND/OR nesting.

Business Scenario


Quote
Zylker, a financial institution, processes loan applications through a rigorous multi-stage approval life cycle. The organization uses Zoho CRM to manage all applications in a custom module called Loan Applications.
The loan approval process is governed by a Blueprint that enforces structured state transitions. Each transition contains specific eligibility criteria that must be satisfied before a loan officer or approval manager can move the application to the next stage.

The Operational Problem

The most complex transition in this Blueprint is Approve Loan. It contains multiple nested criteria conditions organized using grouped AND/OR logic.
When this transition becomes unavailable to a loan manager, they typically check the View Configured Actions section available in the record detail page, where Blueprint transitions are displayed. However, the criteria shown for each upcoming transition are presented only as a flat list of conditions.


Because of this, the loan manager cannot clearly understand:
  1. how the conditions are grouped,
  2. which AND/OR combinations are being evaluated,
  3. or which exact nested condition is preventing the transition.
Currently, there is no way for users to visualize the actual nested criteria structure without contacting a CRM administrator to inspect the Blueprint configuration manually. This creates an operational bottleneck. A loan application that is otherwise ready for approval may remain delayed simply because the loan manager could not identify the blocking condition and had to wait for clarification from the CRM administrator.

Solution Overview

In this Kaizen post, we will walk you through how to build a Blueprint Criteria Viewer directly inside the record detail page using the newly released Zoho CRM REST API default source in Queries.


Quote
Yes! You heard that right. We can now invoke Zoho CRM API endpoints directly through Queries.

Using this approach, you can:
  1. Retrieve Blueprint transition metadata dynamically
  2. Fetch nested transition criteria using the CRM REST API default source
  3. Parse grouped AND/OR conditions
  4. Help business users instantly understand why a transition is unavailable without involving CRM administrators.
This improves operational transparency, reduces approval delays, and enables faster decision-making for loan processing teams.
Before diving into the implementation, here's a quick overview of the new source type that makes this possible.

The New "Zoho CRM REST API" Source

The Zoho CRM REST API source is a built-in default source available in Queries. It provides native access to Zoho CRM REST API endpoints directly within the Query Workbench, using the currently logged-in user's session for authentication. No additional connection or OAuth configuration is required.

While the Module and COQL source types are designed for CRM record retrieval, the Zoho CRM REST API source enables access to CRM metadata. This includes module definitions, field configurations, page layouts, user records, profiles, pipelines, related list settings and so on.


Implementation

Step 1: Create a Blueprint for module "Loan Applications"


 

Add the states and transitions and configure the criteria for each tran
sition.



Step 2: Create a Query to fetch the Blueprint transition criteria.
  1. Go to Setup > Developer Hub > Queries.
  2. Click Create Query, provide the Query Name  and click Next.
  3. In the Query Workbench, change the Source to Zoho CRM REST API.
  4. Provide the GET Blueprint API endpoint relative path and pass the record ID as variable in the Query.  


     /v8/Loan_Application/{{application_record_id}}/actions/blueprint

     
      5. If you click Execute Query, then the query will return the following.
      6. Provide the code to the Serializer to format the response according to your requirements.

The above code will return the response with the transition criteria details, current state, next state and whether the criteria matched or not. 

7. Click Execute Query to test the response, then and click Save.

The Serializer returns the following response:

[
  {
    "current_state": "Under Review",
    "transition_name": "Send For Verification",
    "next_state": "Verification Pending",
    "criteria_matched": "false",
    "criteria": "( ( Credit Score < 750 OR Fraud Check Status is Pending ) OR Risk Category is High )"
  },
  {
    "current_state": "Under Review",
    "transition_name": "Reject Loan",
    "next_state": "Rejected",
    "criteria_matched": "false",
    "criteria": "( ( Fraud Check Status is Failed OR Risk Category is High ) OR Credit Score < 500 )"
  },
  {
    "current_state": "Under Review",
    "transition_name": "Approve Loan",
    "next_state": "Approved",
    "criteria_matched": "false",
    "criteria": "( ( ( ( ( ( ( ( ( Loan Amount > 500000 AND Credit Score > 750 ) AND ( Customer Type is Premium OR Existing Customer is true ) ) AND ( Risk Category is Low OR Eligibility Score > 80 ) ) AND KYC Verified is true ) AND PAN Verified is true ) AND Income Tax Verified is true ) AND Fraud Check Status is Passed ) AND Manager Approval is true ) AND Compliance Approval is true )"
  }
]


Step 3 : Associate the query with a Related List on the record detail page of the Loan Applications module.
  1.  Open a record, click Add Related List, and select Queries from the list.
  2.  Associate your Query from the list of queries displayed on the following screen.
  3.  Provide the Related List name and map the record ID variable to the query.

Now the Query results for that record will be visible inside the Related List you created.

The Outcome


Voila! No more switching between records and Blueprint configuration screens. Users can now visualize complete Blueprint transition logic, including nested AND/OR criteria, directly from the record detail page.

We hope you found this post useful. 
We would love to hear from you! Write us at support@zohocrm.com.

Happy Querying !


    Access your files securely from anywhere


              All-in-one knowledge management and training platform for your employees and customers.






                                    Zoho Developer Community




                                                          • Desk Community Learning Series


                                                          • Digest


                                                          • Functions


                                                          • Meetups


                                                          • Kbase


                                                          • Resources


                                                          • Glossary


                                                          • Desk Marketplace


                                                          • MVP Corner


                                                          • Word of the Day


                                                          • Ask the Experts



                                                                    • Sticky Posts

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


                                                                    Manage your brands on social media



                                                                          Zoho TeamInbox Resources



                                                                              Zoho CRM Plus Resources

                                                                                Zoho Books Resources


                                                                                  Zoho Subscriptions Resources

                                                                                    Zoho Projects Resources


                                                                                      Zoho Sprints Resources


                                                                                        Qntrl Resources


                                                                                          Zoho Creator Resources



                                                                                              Zoho CRM Resources

                                                                                              • CRM Community Learning Series

                                                                                                CRM Community Learning Series


                                                                                              • Kaizen

                                                                                                Kaizen

                                                                                              • Functions

                                                                                                Functions

                                                                                              • Meetups

                                                                                                Meetups

                                                                                              • Kbase

                                                                                                Kbase

                                                                                              • Resources

                                                                                                Resources

                                                                                              • Digest

                                                                                                Digest

                                                                                              • CRM Marketplace

                                                                                                CRM Marketplace

                                                                                              • MVP Corner

                                                                                                MVP Corner









                                                                                                  Design. Discuss. Deliver.

                                                                                                  Create visually engaging stories with Zoho Show.

                                                                                                  Get Started Now


                                                                                                    Zoho Show Resources

                                                                                                      Zoho Writer

                                                                                                      Get Started. Write Away!

                                                                                                      Writer is a powerful online word processor, designed for collaborative work.

                                                                                                        Zoho CRM コンテンツ




                                                                                                          Nederlandse Hulpbronnen


                                                                                                              ご検討中の方





                                                                                                                        • Recent Topics

                                                                                                                        • Automate Backups

                                                                                                                          This is a feature request. Consider adding an auto backup feature. Where when you turn it on, it will auto backup on the 15-day schedule. For additional consideration, allow for the export of module data via API calls. Thank you for your consideration.
                                                                                                                        • Why can't we choose Fixed Asset account for Purchased Items? (eTims issue?)

                                                                                                                          Hello, When the company purchase items not for sale and not supposed to be in the inventory stock, like equipment for operational use, there is no way to access the Fixed Asset accounts in the drop down list. Is that an eTims limitation again? Or something
                                                                                                                        • "Track Inventory for this item" is forced checked by default for goods items (eTims issue?)

                                                                                                                          Hello, Since connecting our Zoho books to eTims (Kenya) the "Track Inventory for this item" is forced checked by default (eTims issue?) in the Item creation page for any type of goods. So when purchasing anything that the company does not intend to sale,
                                                                                                                        • Zoho CRM Functions: Redesigned Interface, Rich Analytics, and Multi-Language Support

                                                                                                                          Hello everyone! We have given Functions in Zoho CRM a major overhaul with a new interface that makes it easier to build, organize, monitor, and troubleshoot your functions throughout their lifecycle. As part of this revamp, we have also introduced a unified
                                                                                                                        • Can you import projects into Zoho Projects yet?

                                                                                                                          I see some very old posts asking about importing project records into Zoho Projects. But I can't find anything up to date about the topic. Has this functionality been added? Importing tasks is helpful. But we do have a project where importing projects
                                                                                                                        • reset password

                                                                                                                          Hi I need to reset my password and need help
                                                                                                                        • Is it possible to set a value to a field based on certain conditions

                                                                                                                          Greetings Say i have a field that i want to set its value based on the value of another field.. for example if "number" field has value greater than 10, i want to set my field's value to X. Or if radio group had option 1 selected, then i want to set my
                                                                                                                        • Native SMS and MMS Channel Support

                                                                                                                          89% of US consumers say they prefer to communicate with businesses via SMS / MMS (aka "texting"). (link) Unfortunately, Zoho Desk does not currently support the most popular channel for consumer communications in the United States. For those of us in
                                                                                                                        • Zoho CRM Layout Rules: Nine New Actions, Profile-Based Execution, and Interactive Preview

                                                                                                                          Hello everyone, Availability: This feature is now available for customers in the JP and SA DCs. It is planned to be released for other customers in soon. We’re excited to announce powerful new enhancements to Layout Rules in Zoho CRM - a feature built
                                                                                                                        • Global Sets for Multi-Select pick lists

                                                                                                                          When is this feature coming to Zoho CRM? It would be very useful now we have got used to having it for the normal pick lists.
                                                                                                                        • How to add line breaks in formula with Concat?

                                                                                                                          I am trying to combine different fields with a formula field, but want to add line breaks.  I.e. the current code looks like:  Concat(${Contacts.Company_Name}, ' ' ,${Contacts.First_Name}, ' ' ,${Contacts.Last_Name}) And the result should be:  John Doe
                                                                                                                        • Introducing spam detection for webforms: An additional layer of protection to keep your Zoho CRM clean and secure

                                                                                                                          Greetings all, One of the most highly anticipated feature launches—Spam Detection in webforms—has finally arrived! Webforms are a vital tool for record generation, but they're also vulnerable to submissions from unauthenticated or malicious sources, which
                                                                                                                        • Is Zoho Assist Secure Connect even practical for 1 person shop?

                                                                                                                          I was gun ho with Zoho Assist to replace my existing Remote Access product I have been using but I need to implement MFA on each unattended connection. Right now each of these connections in my other product has a rotating token that I have enter off
                                                                                                                        • Join the Zoho Desk Virtual Classroom Training (VCRT)

                                                                                                                          Hello everyone, Have you heard about Zoho's Virtual Classroom Training (VCRT)? Zoho Desk's Virtual Classroom Training offers end-to-end training for Zoho Desk users. Join the VCRT and get hands-on guidance for setting up Zoho Desk and getting your business
                                                                                                                        • Zoho CRM's revamped timeline view now extends to 3 years and support notes, filters, and email statuses

                                                                                                                          Editions: All DCs: All Release plan: These enhancements are being rolled out to customers in a phased manner. They will be available to most organizations by the end of May. For organizations with huge volumes of data, they will be available by the end
                                                                                                                        • Zoho Mail App Unable to connect to server

                                                                                                                          Hi all, For the last two weeks, my Zoho Mail App on my iPhone which has worked fine up to this point has been unable to connect to the mail server. I can't access my emails even though I will get notification banners on the screen saying that they have been received. I can open Safari on my phone and then log in that way. This issue happens when I'm connected to wifi and on my phone data.  I've tried deleting the app several times and reinstalling, and have updated to the latest version. But it still
                                                                                                                        • Specific ListView Canvas on Canvas Home Page Always Loads Most Recent ListView, Not the One Specified

                                                                                                                          I had mentioned this to ZOHO, but I mainly wanted to see if others in the Community are also facing this problem. I created a Canvas ListView for a Custom Module, and then created a Canvas Home page (technically on a tab item, but I'm not sure if that
                                                                                                                        • Add the Zoom Option to the Camera

                                                                                                                          Hi, I use the ZOHO Forms Camera so I can manage metadata, compression, etc. but this doesnt have the zoom parameter activated, so when we have photos in a tight space and want to use 0.5 for example, we can't, can this be enabled please. Thanks Dan
                                                                                                                        • Manage booking pages from your Android phone

                                                                                                                          Hello everyone! We are happy to announce that users can now add and manage booking pages from their Bigin Android app. It is a multi-step form that users can create for purposes like booking appointments, scheduling calls or meetings, conducting webinars,
                                                                                                                        • New UI - Color Preference Not Saving Permanently

                                                                                                                          Small, not very urgent problem I'd like to share regarding the new UI theme color. I've changed my theme preference to the default blue color around 20 times by now. It always reverts to a green color theme. I've followed the instructions of changing
                                                                                                                        • Automating Employee Birthday Notifications in Zoho Cliq

                                                                                                                          Have you ever missed a birthday and felt like the office Grinch? Fear not, the Cliq Developer Platform has got your back! With Zoho Cliq's Schedulers, you can be the office party-cipant who never forgets a single cake, balloon, or awkward rendition of
                                                                                                                        • Unbundle feature for composite items

                                                                                                                          We receive composite items from our vendors and sell them either individually or create other composite items out of them. So, there is a lot of bundling and unbundling involved with our composite items. Previously, this feature was supported in form
                                                                                                                        • Inventory Barcode Creation - Add Picture of Item

                                                                                                                          Hi I am trying to set up bar code labels and include a picture of the item on the label - any idea on how to add that field to the barcode generator?
                                                                                                                        • Gemini Action - Add "inineData" Support

                                                                                                                          Thank you guys for adding a Gemini action. I like Gemini models for the "grunt work" of AI, as they have the cheapest tokens of the trustworthy providers One thing that's missing in the action, though, is the ability to pass file data. If you pass a base64-encoded
                                                                                                                        • Protect backed up and exported data using password encryption

                                                                                                                          Hello everyone, Protecting live data is crucial for any organization or product, as it contains sensitive customer information. However, protecting data does not end within the platform. Backup and export files often contain sensitive information and
                                                                                                                        • Smarter holiday planning with yearly-specific Holiday Lists

                                                                                                                          Hello everyone! Managing holidays and business hours is now easier and more efficient. Holiday Lists now support holidays that fall on different dates every year, while business hours now supports more than one holiday list. This helps businesses manage
                                                                                                                        • Zoho Projects - Cloning a task does not trigger task workflow when created

                                                                                                                          Hello! I have a Project where my team uses a set of tasks from a tasklist as templates, so we could simply clone it and drag it to another list in kanban view to avoid creating a new one from scratch. The process works well, but after cloning it the new
                                                                                                                        • Best way to setup Inventory bin tracking for products with multiple boxes/crates

                                                                                                                          Hi - we need some advice from the community on setting up Items in the Inventory for products with multiple crates. We have large products in our warehouse where the product is delivered as two large (double pallet) crates. We've setup the Items for these
                                                                                                                        • Cliq iOS can't see shared screen

                                                                                                                          Hello, I had this morning a video call with a colleague. She is using Cliq Desktop MacOS and wanted to share her screen with me. I'm on iPad. I noticed, while she shared her screen, I could only see her video, but not the shared screen... Does Cliq iOS is able to display shared screen, or is it somewhere else to be found ? Regards
                                                                                                                        • not able to access Zoho from home WIFI

                                                                                                                          for some reasone i am not able to access Zoho on my laptop or my iphone while i am connected to my home Wifi, i am able to access these sites both on laptop as well as Iphone and associated apps on any other Wifi as well as when I am on my 4G connection
                                                                                                                        • Five Guided Conversations Updates in Zoho Desk

                                                                                                                          Hello everyone, Guided Conversations is getting updates that make it easier to create more inclusive customer experiences, retain important conversation context, customize your widget, keep track of changes, and connect with external services. Here are
                                                                                                                        • zoho desk

                                                                                                                          Hello, Did Zoho Desk have any issues today? Are tickets coming in late? I have an email account linked, and messages seem to be arriving with a delay—some email threads aren't coming through completely, and so on.
                                                                                                                        • An important update for Zoho Cliq desktop users

                                                                                                                          The latest version of the Zoho Cliq desktop app (v1.8.0) will no longer be supported on macOS 10.15 Catalina and earlier versions. This is because the framework we use (Electron) no longer supports some older macOS versions. If you’re using macOS 10.15
                                                                                                                        • Simplify eSignatures: Automate document workflows with Zoho WorkDrive

                                                                                                                          Hello everyone, We’re excited to invite you to our upcoming live webinar, where Zoho WorkDrive and Zoho Sign will come together to show you how to simplify and automate document workflows. From creating and collaborating on documents to approvals, e-signatures,
                                                                                                                        • Function #7: Fetch a value from Deal in Zoho CRM to the related Estimate in Zoho Books

                                                                                                                          We're here with another function for those using the integration with Zoho CRM. You know that potentials can be linked to transactions in Zoho Books. But if you're including additional details about a Deal (potential) in Zoho CRM and you want to inherit
                                                                                                                        • Turn off workflow Applied pop-up

                                                                                                                          hi We are new to Desk. I have a rule to set to "waiting for customer" when agent sends reply. This comes up every time. How to i turn off? Or am i seeing as admin.
                                                                                                                        • Workflows being applied and the Large unwanted popup

                                                                                                                          When a workflow is being applied do to an action, then the Agent is left with a large Window asking if they would like the see the changes this workflow did. Is there any way to disable this prompt from appearing?
                                                                                                                        • Maintenance notice for Zoho CommunitySpaces US data centers on August 23, 2026

                                                                                                                          Dear customers, We have scheduled a maintenance activity for Zoho CommunitySpaces in our United States (US) data centers on August 23, 2026, from 1:30 a.m. to 2:00 a.m. During this 30-minute maintenance window, Zoho CommunitySpaces will be temporarily
                                                                                                                        • Knowledge base: The nitty-gritty of SEO tags

                                                                                                                          A well-optimized knowledge base with great SEO can benefit your company by allowing customers to find help articles and support resources using search engines. This enables customers to quickly and efficiently find the information they need without direct
                                                                                                                        • zoho desk: Can tickets be created from Microsoft Teams messages?

                                                                                                                          I am trying to see if there is a way to integrate Microsoft teams with zohodesk. we have a few customers who prefer to communicate requests through Teams, and it would be great to create tickets when they do.
                                                                                                                        • Next Page