Kaizen #11 - The $Properties in Zoho CRM #API

Kaizen #11 - The $Properties in Zoho CRM #API

Hello everyone!

Welcome back to yet another post in the Kaizen series! 
This week, we will discuss the  $Properties in Zoho CRM .

What will you learn from this post?

  • What are $properties?
  • $properties common to all the modules
  • Module-specific $properties

1. What are the $properties?

The $properties represent the  derived properties of a record in Zoho CRM. They are not available as fields in Zoho CRM. For instance,  $converted —It represents the state of a lead or a quote. If you convert a lead or a quote into a contact/account (or) a sales order/invoice, the value for $converted becomes true. 
Since they are derived, you cannot set these properties while creating or updating leads/quotes. 



2. $properties common to all the modules

All the $properties are read-only keys.

$Property
Description
$currency_symbol
string
Represents the corresponding currency symbol of the currency chosen. For instance, for Dollars, the currency symbol would be—
"$currency_symbol": "USD"
$review_process
JSON object
Represents the current state of the record in the review process. For instance, if the record is resubmitted—
"$review_process": { 
                "approve": false, 
                "reject": false, 
                "resubmit": true 
            } 
$review
string
Represents the review status of the record.

null - The record does not come under the review process.
approved - The record is approved.
unreviewed - The record is yet to be reviewed.
$process_flow
boolean
Represents if the record is in blueprint data.

true - The record is a blueprint data.
false - The record is not associated with any blueprint.
$approved
boolean
Represents if the record is approved or not.

true - The record is approved.
false - The record is not approved.
$approval
JSON object
Represents if the current user can approve the record in approval. For instance, if the current user can approve the record—
  "$approval": {
                "delegate": true,
                "approve": true,
                "reject": true,
                "resubmit": false
            }
$editable
boolean
Represents if the record is editable or not.

true - Record can be edited.
false - Record cannot be edited.

3. Module-Specific $properties

Except $send_notification and $line_tax, all the other module-specific $properties are read-only keys.

Property Details
Description
$converted
boolean
Represents the state of a lead/quote.

true - The record is converted.
false - The record is not converted.

Modules - Leads, Quotes
HTTP Method - GET
$converted_detail
JSON object
Represents conversion details of a lead.

   "$converted_detail": {
        "deal": null,
        "convert_date": "2019-12-17T01:58:25+05:30",
        "contact": "4150868000000939001",
        "converted_by": "4150868000000225013",
        "account": "4150868000000413103"
    }

Modules - Leads
HTTP Method - GET
$followers 
JSON Array
Represents the details of the followers of that deal.

  "$followers": [
        {
            "name": "User_1901",
            "id": "4150868000000225013"
        }
    ]

Modules - Deals
HTTP Method - GET
$followed
boolean
Represents if the current user is following that particular deal or not.
 
true - The current user is following the deal.
false - The current user is not following the deal.

Modules - Deals
HTTP Method - GET
$se_module
string
Represents to which module a task, event, or call is related to. It depends on the value stored in the "Related to" field.

"$se_module": "Leads"

Modules - Tasks, Events, Calls
HTTP Method - GET
$calender_booking_event
boolean
Represents if the event is a calendar booking event.

true - It is a calendar booking event.
false - It is not a calendar booking event.

Modules - Events
HTTP Method - GET
$recurrence_id
string
Represents the unique ID of the recurrence rule.

  "$recurrence_id": "4150868000000383036"

Modules - Events
HTTP Method - GET
$u_id
string
Represents the unique ID of the recurring event. 

"$u_id": "4150868000000383036"

Modules - Events
HTTP Method - GET
$meeting_details
JSON object

Represents the details of the online meeting.

"$meeting_details": {
        "tool_name": "ZohoMeeting",
        "joinmeeting_url": " https://meeting.zoho.com/join?key=1094205335 ",
    }

Modules - Events
HTTP Method - GET
$send_notification
boolean
You can set if an email notification has to be sent to all the participants of the event or not.

true - Send notification to all the participants of the event.
false - Do not send a notification to all the participants of the event.

Modules - Events
HTTP Method - GET, POST, PUT
$calender_booking_call
boolean
Represents if the call is a calendar booking call.

true - It is a calendar booking call.
false - It is not a calendar booking call.

Modules - Calls
HTTP Methods - GET
$taxable
boolean
Represents if the inventory line item (product in inventory module) is taxable or not. 

true - The inventory line item is taxable.
false - The inventory line item is not taxable.

Modules - Products
HTTP Methods - GET
$line_tax
JSON Array
You can set the tax on individual product line items using this property.

 "$line_tax": [
        {
            "percentage": 0,
            "name": "Sales Tax",
            "id": null,
            "value": 0
        },
        {
            "percentage": 0,
            "name": "Vat",
            "id": null,
            "value": 0
        }
    ]

Modules - Quotes, Invoices, Sales Orders, Purchase Orders
HTTP Method - GET, POST

We hope you found this post useful. Please reach out to us if you have any questions, or let us know in the comment section.

We wish you all a happy new year!
Cheers! 

Next 'Kaizen' - Bulk Read API



    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

                                                                                                                • WeTravel + Zoho CRM Integration - Has Anyone Built a Connector or Extension?

                                                                                                                  Hi all, I'm exploring options for integrating Zoho CRM with WeTravel (booking & payment platform for tour operators). Zapier seems to be the common method but seems limited. I'm wondering if anyone in the community has developed a more comprehensive solution,
                                                                                                                • Undo article like/dislike

                                                                                                                  It seems to be not possible to undo your like/dislike for an article. Would be great if you can. Kind regards, Helen
                                                                                                                • New UI for Writer - Disappointed

                                                                                                                  I've been enjoying Zoho Writer as a new user for about 6 months, and I really like it. One of my favorite things about it is the menu bar, which you can hide or leave out while still seeing most of your page because it is off to the left. I think this
                                                                                                                • What are the create bill API line item requiered fields

                                                                                                                  While the following documentation says that the line items array is requiered it doesn't say what if any files are requiered in the array. Does anyone know? API documentation: https://www.zoho.com/inventory/api/v1/bills/#create-a-bill I'm trying to add
                                                                                                                • WorkDrive issues with Windows Explorer Not Responding

                                                                                                                  We are using WorkDrive to collaborate on editing video content. We have a lot of files and quite a few are a few gigs. Recently anytime I try and work with the files Explorer freezes for a couple minutes whether it's dragging the files into Premiere or
                                                                                                                • Connecting Zoho Inventory to ShipStation

                                                                                                                  we are looking for someone to help connect via API shipStation with Zoho inventory. Any ideas? Thanks. Uri
                                                                                                                • Using IMAP configuration for shared email inboxes

                                                                                                                  Our customer service team utilizes shared email boxes to allow multiple people to view and handle incoming customer requests. For example, the customer sends an email to info@xxxx.com and multiple people can view it and handle the request. How can I configure
                                                                                                                • When Does WorkDrive integrate with Books?

                                                                                                                  When Does WorkDrive integrate with Books?
                                                                                                                • CRM x WorkDrive: File storage for new CRM signups is now powered by WorkDrive

                                                                                                                  Availability Editions: All DCs: All Release plan: Released for new signups in all DCs. It will be enabled for existing users in a phased manner in the upcoming months. Help documentation: Documents in Zoho CRM Manage folders in Documents tab Manage files
                                                                                                                • Introducing Radio Buttons and Numeric Range Sliders in Zoho CRM

                                                                                                                  Release update: Currently out for CN, JP, AU and CA DCs (Free and standard editions). For other DCs, this will be released by mid-March. Hello everyone, We are pleased to share with you that Zoho CRM's Layout Editor now includes two new field formats—
                                                                                                                • POP mailbox limits

                                                                                                                  If I am accessing a remote POP mail server using Zoho Mail is there a mailbox quota for the account or is it all related to my mail account storage limits?
                                                                                                                • Warranty Service and Repair in Zoho FSM

                                                                                                                  Hi There, We are a retail store that sells products and also performs installations and repairs. Our field technicians handle this work. Some repairs are covered by manufacturers, who reimburse us for both parts and labour. In these cases, we perform
                                                                                                                • Create Receipt of a Donation (not a sale)

                                                                                                                  We are a non-profit organization that receives general donations. How do I create a receipt of payment for the donor and categorize the payment as a Gift? I tried the method of creating an invoice; however that automatically created a "Sales" transaction
                                                                                                                • Zoho Sheet for Desktop

                                                                                                                  Does Zoho plans to develop a Desktop version of Sheet that installs on the computer like was done with Writer?
                                                                                                                • WhatsApp phone number migration

                                                                                                                  Hi @Gowri V and @Pheranda Nongpiur, Thanks for implementing the promised enhancements to the integration between Zoho CRM and WhatsApp. The previous discussion has been locked, so I'm opening this new one. I am copying below a specific
                                                                                                                • How do I create an update to the Cost Price from landed costs?

                                                                                                                  Hi fellow Zoho Inventory battlers, I am new to Zoho inventory and was completely baffled to find that the cost price of products does not update when a new purchase order is received. The cost price is just made up numbers I start with when the product
                                                                                                                • Price Managment

                                                                                                                  I have been in discussions with Zoho for some time and not getting what I need. Maybe someone can help explain the logic behind this for me as I fail to understand. When creating an item, you input a sales rate and purchase rate. These rates are just
                                                                                                                • Actual vs Minimum

                                                                                                                  Hi all, I am sure I am not the only one having this need. We are implementing billing on a 30-minute increment, with a minimum of 30 minutes per ticket. My question is, is there a way to create a formula or function to track both the minimum bill vs the
                                                                                                                • Generate leads from instagram

                                                                                                                  hello i have question. If connect instagram using zoho social, it is possible to get lead from instagram? example if someone send me direct message or comment on my post and then they generate to lead
                                                                                                                • Kaizen #234 - Automating Deal Handoff with Zia Assistant API, Workflow, Deluge, and Widget in Zoho CRM

                                                                                                                  Hello all! Welcome back to a fresh Kaizen week. In this post, we will explore how to automate the deal handoff process in Zoho CRM using Zia Assistant API + Workflow + Deluge + Widgets. Here’s how the final output looks when a deal is reassigned 1. Deal
                                                                                                                • How do you print a refund check to customer?

                                                                                                                  Maybe this is a dumb question, but how does anyone print a refund check to a customer? We cant find anywhere to either just print a check and pick a customer, or where to do so from a credit note.
                                                                                                                • Ability to assign Invoice Ownership through Deluge in FSM

                                                                                                                  Hi, As part of our process, when a service appointment is completed, we automated the creation of the invoice based on a specific business logic using Deluge. When we do that, the "Owner" of the invoice in Zoho FSM is defaulted to the SuperAdmin. This
                                                                                                                • All new Address Field in Zoho CRM: maintain structured and accurate address inputs

                                                                                                                  Availability Update: 29 September 2025: It's currently available for all new sign-ups and for existing Zoho CRM orgs which are in the Professional edition exclusively for IN DC users. 2 March 2026: Available to users in all DCs except US and EU DC. Latest
                                                                                                                • Enhancement to ICR’s field prompting: Preferred data extraction using advanced field prompting

                                                                                                                  Dear Customers, We hope you’re well A quick background Intelligent Character Recognition (ICR) comes as part of Zia’s optical recognition capability called Zia Vision. When we introduced it last April, the data extraction was training-based and was applicable
                                                                                                                • See a list of all records enrolled in a cadence?

                                                                                                                  I am looking for a way to see a list of all leads or contact currently enrolled in a cadence. I do not see any way to do this through the cadence UI.
                                                                                                                • Limitation in chart of accounts

                                                                                                                  There is a limitation of 4000 accounts in chart of accounts  Zoho needs to remove this limit
                                                                                                                • How do I change the account bank charges are charged to?

                                                                                                                  I want bank charges charged to my Credit Card Fees account. Is there a way to do this?
                                                                                                                • Real signature in Zoho Expense PDF report ?

                                                                                                                  Hello ! Is there a way to put a real signature on the signature line when a PDF report is generated in Zoho Expense? Through Zoho Sign or another way? Can't seem to make it work.
                                                                                                                • Copy paste settings

                                                                                                                  Hello all i have 2 organizations running in ZOHO books in one organization i have customised Tax rates, codes and customized templates instead of manually doing again in org 2 can i have some shortcut to copy paste or export and import??
                                                                                                                • Custom TDS on Vendor Credits via API

                                                                                                                  Hi, We are using Zoho Books APIs for posting Bills and vendor credits. We are unable to post custom TDS amount posting vendor credits. Can you please share the API spec and Payload that need to be sent for Custom TDS for Vendor Credits.
                                                                                                                • "Unlink" Advance from Bill without Deleting the Payment Record

                                                                                                                  I am writing to highlight a significant workflow issue in Zoho Books (India Edition) regarding Vendor Advances and Bills. The Scenario: I recorded an Advance Payment to a vendor. I matched/reconciled this payment in the Banking module. I received a Bill
                                                                                                                • Advance Payment Record Removed When Deleting Applied Credit from Bill

                                                                                                                  Hello, So while working with vendor advance payments, I noticed that removing the applied credit from a bill also removes the corresponding entry from the Payments Made section. What I did : Recorded an advance payment to a vendor through Payments Made.
                                                                                                                • What is the best way to convert MSG file to Word format?

                                                                                                                  The best way to convert MSG files to Word format is by using a reliable and professional tool Aryson MSG file Converter. Manual methods are often time-consuming and may not preserve email formatting, attachments, or metadata accurately. In contrast, Aryson
                                                                                                                • Address Typeahead Extension for Zoho Books

                                                                                                                  I installed the Address Typeahead extension for zoho books but when I went to configure it, it said that that version was deprecated. Is there a newer version somewhere?
                                                                                                                • How to create a new Batch and update Stock via Inventory?

                                                                                                                  Hi everyone, We are building an automation where a user enters batch details (Batch Number, Mfg Date, Expiry, and Quantity) into a Custom Module. I need this to trigger an API call to Zoho Inventory to: Create the new batch for the item. Increase the
                                                                                                                • Zoho Projects : Task should auto-update to 'In Progress' if timer started

                                                                                                                  Namaskaram. Right now, if a Task's timer is started, the Task stays in 'Not Started' status. One has to manually update it to 'In Progress'. From a #uxdesign standpoint, it is an unnecessarily two step process to start working on a task. It would be better that, if I start the timer on a task, it should automatically change to 'In Progress' status. Crafted with ❤️ Zoho Gurus | Zoho One Practice Team @ CubeYogi Zoho Authorised Partner | 7+ Yrs | 200+ Projects | 100+ Customers
                                                                                                                • Invoice template with sales tax totals

                                                                                                                  Hi everyone,  I am trying to edit my invoice template so that only the total sales tax collected for my tax group shows up. Right now, under by sub total, each individual tax shows up and that takes up a lot of unnessary space, so I just want the one
                                                                                                                • Zoho Delayed Posting & Loss of Article Thumbnails on BlueSky

                                                                                                                  Hello! I am wondering if anyone else has had the either of the following issues when posting to socials via Zoho and if there is a fix? 1. Post says it is scheduled or it is live when sent off via Zoho but it doesn't show up on socials till some time
                                                                                                                • Connection Not Secure (Certificate Mismatch) Error

                                                                                                                  Hi, Just a fyi, when you go to https://bigin.zohocloud.ca/bigin/Home you get a "Your Connection Is Not private" error. (Certificate mismatch to domain.) I get to that page after I have signed up and signed in as a customer and select the Access Bigin
                                                                                                                • Recording the Investment

                                                                                                                  Hello, - One Investor Invested to our company, So how do we record investment which we received in our bank in the Zoho books ? - How do we record if we provide shares to the investor in the Zoho books? Thanks
                                                                                                                • Next Page