Actions APIs - Field Updates
Hello all!!
Welcome back to a fresh Kaizen week.
In the previous weeks, we covered Workflow Rules APIs, Actions APIs - Email Notification APIs, and Tasks Update APIs.
This week, we will continue with another Actions API - the Field Update API in Zoho CRM.
Field Updates in Zoho CRM
The Field Update option helps you automatically update specific field values in records when the associated workflow rule is triggered.
Note: Field Updates can also be used in Blueprint and Approval Processes, but in this post, we will focus only on Field Updates used with Workflow Rules in Zoho CRM.
When multiple leads enter Zoho CRM each day, from small to large industries, the Sales team manages all these entries inside a module. Every single lead is important for a company, whether it comes from a small or large industry. High-profit leads should not be missed and must be treated with high priority, frequent follow-ups, and faster actions to convert them into won deals.
High-profit deals without Field Update
There are chances of missing or failing to prioritize high-profit deals when all entries are cluttered inside the same module. This leads to manual mistakes and confusion for the Sales team. It becomes manual work, which increases the possibility of missing high-profit Leads.
High-profit deals with Field Update
A Field Update + Workflow Rule can solve these issues by creating an automated process. This avoids manual intervention and reduces errors.
Use case
Zylker, an IT solutions provider, wants to give high-priority attention to leads coming from large industries or leads that have a high lead score, especially when the Lead Status is Not Contacted.
Whenever a lead has a Lead Score ≥ 80 and is Not Contacted, the system should automatically update a field called Profit Category and set it to High Profit.
Why Lead Score for our use case?
Lead Score shows how active and interested a lead is. A score of 80 or above means the lead is highly engaged and more likely to convert. This makes it a dependable way to identify important leads that need quick attention.
Scenario
Whenever a lead meets the following conditions:
- Lead Score ≥ 80
- Lead Status = Not Contacted
The system should automatically update the Profit Category field to High Profit, and add a Contact Immediately tag. This helps the Sales team quickly identify high-profit records even when many records are cluttered in the module.
This can be achieved using a Field Update combined with a Workflow Rule.
Why not just use a Custom View?
A custom view can filter and display leads that meet these conditions, but it still depends on the Sales team to open the view and take action. In a busy Leads module, important leads can be missed or delayed. Also, if you want to perform dependent actions, you will need to create and schedule a custom function manually.
With a Workflow and Field Update, the system emails and also trigger many other actions like Field Update, Webhooks, and so on to your executives about these leads automatically. In our case, the Profit Category and tag are updated the moment the lead meets the condition, making high-profit leads stand out everywhere in CRM - without relying on manual checks or someone remembering to look at a view.
Profit Category mapping based on Lead Score
Profit Category is a custom picklist field in the Leads module.
The following table shows how Zylker classifies profit categories based on Lead Score:
Lead Score | Profit Category |
20-40 | Minimal Profit |
40-60 | Average Profit |
60-80 | Good Profit |
80+ | High Profit |
In this use case, we focus only on the High Profit category.
Let us now see how to enable a Field Update in Zoho CRM through the UI.
Creating a Field Update via UI
To create a Field Update in Zoho CRM, follow the steps below:
- Go to Setup > Automation > Actions > Field Updates.
- Click Create Field Update.
- Enter the Name of the field update.
- Select the Module.
- Choose the Field that should be updated.
- Provide the value to be updated that must be applied.
- Save the Field Update.
Field Update Configuration
In this use case, a Field Update is created to modify the Profit Category field when the workflow rule is triggered.
Field Update Details:
- Name: Profit Category
- Module: Leads
- Field to Update: Profit Category
- New Value: High Profit
This Field Update will be used as an action inside the workflow rule.
How to create the workflow for this use case and associate this Field Update with the workflow has been covered in the following section of this post.
UI - Field Update Creation ViewCreating a Field Update via API
You can create a Field Update using the Create Field Update API available from Zoho CRM API version 8.
Request URL: {{api-domain}}/crm/v8/settings/automation/field_updates
Request Method: POST
Input JSON
{ "field_updates": [ { "name": "Profit Category ", "module": { "api_name": "Leads", "id": "5725767000000002175" }, "type": "static", "feature_type": "workflow", "field": { "api_name": "Profit_Category", "id": "5725767000008570298" }, "value": "High Profit" } ] } |
Keys explanation
Key | Explanation |
field_updates
| Holds all details to create a field update. |
name | Field Update name |
module | Specify the module details |
module.api_name | Represents the module API name. In our case, it is "Leads" module. |
module.id | Represents the System ID for the module |
type | Represents the Update type. Usually “static” for fixed-value updates. |
feature_type | Represents that this Field Update is for workflow Rules. |
field | Represents which field should be updated. |
field.api_name | Represents the field API name. |
field.id | Represents the unique ID of the field. |
value | The value to be updated |
Sample Response
{ "field_updates": [ { "code": "SUCCESS", "details": { "id": "5725767000008604002" }, "message": "field update deleted successfully", "status": "success" } ] } |
A note on the unique ID
You can add:
- You need this ID to retrieve, update, and delete the Field Update later.
Retrieve your Field Update
You can retrieve a Field Update by using the Get Field Update API. It lists all available Field Update actions available in your org.
Request URL: {{api-domain}}/crm/v8/settings/automation/field_updates/5725767000008604002
Request Method: GET
Sample Response:
Below is the sample response returned by Zoho CRM.
{ "field_updates": [ { "created_time": "2025-11-15T07:57:39-08:00", "update_type": null, "lock_status": { "locked": false }, "apply_assignment_threshold": false, "editable": true, "module": { "api_name": "Leads", "id": "5725767000000002175" }, "related_module": null, "deletable": true, "source": "crm", "type": "static", "created_by": { "name": "Patricia Boyle", "id": "5725767000000411001" }, "notify": false, "feature_type": "workflow", "modified_time": "2025-11-15T07:57:39-08:00", "field": { "api_name": "Profit_Category", "id": "5725767000008570298" }, "dependent_fields": null, "associated": false, "related_records": null, "name": "Profit Category Leads", "modified_by": { "name": "Patricia Boyle", "id": "5725767000000411001" }, "id": "5725767000008604002", "value": "High Profit" } ] } |
Note: This API helps you fetch all the details of a specific Field Update using its unique ID. Also, you can create a workflow and associate the created Field Update action using its unique ID.
Workflow Rule Configuration
Trigger:
- When a Lead is created or edited.
Condition:
- Lead Score is greater than or equal to 80.
- Lead Status is currently Not Contacted.
Actions:
- Associate the created Field Update action: High Profit
- Add a Contact Immediately tag to the record.
Workflow Rule and Field Update action via UI
Configuring Workflow and associating the Field Update actionWorkflow Rule and Field Update action via API
Create a Workflow:
You can use the Configure Workflow Rule API to create a workflow.
Associate the Field Update:
You can associate the Field Update action with the workflow by using the unique ID of the Field Update.
Retrieve the Field Update ID using the Get Field Updates API.
Request URL: {{api-domain}}/crm/v8/settings/automation/workflow_rules
Request Method: POST
Sample Input:
{ "workflow_rules": [ { . . . "execute_when": { "details": { "trigger_module": { "api_name": "Leads", "id": "5725767000000002175" }, }, "type": "create_or_edit" }, "module": { "api_name": "Leads", "id": "5725767000000002175" }, "conditions": [ { "instant_actions": { "actions": [ { "name": "Profit Category", "details": { "module": { "api_name": "Leads", "id": "5725767000000002175" } }, "id": "5725767000008604002", //associating the created Field Update with the Workflow. "type": "field_updates" }, { "name": "High Priority Deal", "details": { "module": { "api_name": "Leads", "id": "5725767000000002175" }, "over_write": false, "tags": [ { "name": "High Priority Deal", "id": "5725767000008570458", "color_code": "#63C57E" } ] }, "id": "5725767000008570470", "type": "add_tags" } ] }, "criteria": { "group_operator": "AND", "group": [ { "comparator": "greater_equal", "field": { "api_name": "Entity_Scores__s.Score", //Lead Score's API name "id": "5725767000002324045" }, "type": "value", "value": "80" }, { "comparator": "contains", "field": { "api_name": "Lead_Status", "id": "5725767000000002611" }, "type": "value", "value": "Not Contacted" } ] } } ] . . . } ] } |
For more details on Workflow Rules using APIs, refer to Kaizen #213 - Workflow APIs - Part 1, Part 2, and Part 3.
Edit your existing Field Update
You can update an existing Field Update using the Update Field Update API. To update it, use the unique ID of the Field Update in the request URL. Use Get Field Update API to get the required Field Update ID.
Request URL: {{api-domain}}/crm/v8/settings/automation/field_updates/5725767000008599001
Request Method: PUT
Input JSON
{ "field_updates": [ { "name": "Profit Category - Updated", //updated the response "field": { "api_name": "Profit_Category", "id": "5725767000008570298" }, "value": "Good Profit" //updated value } ] } |
Note:
- Only the configured modules cannot be updated using the PUT - Field Update API call. The rest of the fields can be updated.
- The updated value must be valid for the field type. For example, picklist fields accept only existing picklist options.
- After updating a Field Update, any workflow linked to it will automatically start using the updated configuration.
Delete Your Existing Field Update
You can delete an existing Field Update using the Delete Field Update API. To delete it, you must use the unique ID of the Field Update in the request URL.
If you do not know the ID, use the Get Field Update API to retrieve it.
Request URL: {{api-domain}}/crm/v8/settings/automation/field_updates/5725767000008599001
Request Method: DELETE
Sample Response:
{ "field_updates": [ { "code": "SUCCESS", "details": { "id": "5725767000008604002" }, "message": "Field update deleted successfully", "status": "success" } ] } |
Note
- You cannot delete a Field Update if it is currently associated with any Workflow, Blueprint, or Approval Process. Remove the Field Update from the workflow first, and then try deleting it.
We hope this post helps you understand how to use Field Updates through the Zoho CRM Actions API - Field Update API.
Try it out, and let us know your experience in the comments section or reach out to us at support@zohocrm.com.
Stay tuned for more insights in our upcoming Kaizen posts!
Cheers!
Workflow Rules and Actions APIs on Kaizen series:
Workflow Rules:
- Kaizen #213 - Workflow APIs - Part 1
- Kaizen #214 - Workflow APIs - Part 2
- Kaizen #215 - Workflow APIs - Part 3 - Create and Update Workflow Rules
Actions APIs:
Topic Participants
Subramanian K
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 thisKaizen #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 howKaizen #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 areKaizen #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
Stock count by bin location
Is there a configuration to make a stock count by bin or area and not by product. these is useful to manage count by area RegardsAdd Prebuilt "Partner Finder" Template with Native Zoho CRM Integration in Zoho Sites To: Zoho Sites Product Team
Hi Zoho Team, We hope you're doing well. We would like to request a prebuilt "Partner Finder" template for Zoho Sites, modeled after your excellent implementation here: 🔗 https://www.zoho.com/partners/find-partner-results.html ✅ Use Case: Our organizationHow Do I Refund a Customer Directly to Their Credit Card?
Hi, I use books to auto-charge my customers credit card. But when I create a credit note there doesn't seem to be a way to directly refund the amount back to their credit card. Is the only way to refund a credit note by doing it "offline" - or manually-Zoho Learn Course Completion Notifications/Triggers/API
Zoho Learn works great and will suit our course creation needs, but it appears to be lacking a bit when it comes to integration with other Zoho services (creator etc.) when it comes to course completion. 1) Is there an API or Zoho Flow trigger for whenEnhanced Recording Permission Controls for Zoho Cliq Meetings (Similar to Zoom)
Hello Zoho Cliq Team, We hope you are doing well. We would like to request an enhancement to the recording permission functionality in Zoho Cliq Meetings. Current Limitation: in Zoho Cliq Only hosts and co-hosts can record a meeting. Participants cannotPhone Connection
When on a call the person on the other end complains that there is static, I am cutting in and out or they can't hear me all. This happens on the cell connection as well.Can't add a sender adress from zoho campaigns
hi, I need to change the sender address for a campaign. When i try to add it i get a message to say 'duplicated email address found while adding your sender address'. This is the first campaign i'm sending so I don't understand why this message is displayed? Thanks JaneExport History timeline
Hi, I have an idea, bout zoho desk history of the ticket it would be great if the agent or admin of the zoho desk can export the timeline of the ticket history for agent report or on other matter.Desk fails to create a new ticket on Reply email
When I send a direct email to support@mysite.com, Desk will create a new ticket as expected. When I REPLY to an email sent from support@mysite.com, Desk will NOT generate a new ticket. This is very bad. How can I fix this? Use case: In a separate systemAsk the Experts 25: Experience the full spectrum of Zoho Desk’s autumn and spring releases for 2025
Hello Everyone, We’re on the 25th episode of our ATE series! It's a true milestone in our live community interactions! It’s been an amazing journey since we started in October 2018. Zoho Desk has come a long way, evolving with the support of a wonderfulAddin Support in Zoho Sheet
Is there any addin support available in zoho sheet as like google marketplace to enhance productivity by connecting with other apps, providing AI data analysis, streamlining business processes, and more?Wise integration in Zoho Books
Hi, it is now time for zoho books to support Wise.com integration for payment links. Wise has launched credit card payments, now about 0.5% cheaper than Stripe. Also their bank payments are much much cheaper than credit cards. Its time for books teamFunction #61: Automatically add free item to the invoice based on item quantity
Hello everyone, and welcome back to another Custom Function Friday! During holiday seasons or special promotions, businesses offer deals like BOGO (Buy One, Get One), Buy 3 Get 1 Free, Buy 2 at 50% off, and much more to attract customers. These promotionsNotes for Items for Future Purchase Order
Next time when I order an item, tau have to make some changes in it, that order has to be placed after 4-5 months, I want to save those changes or points somewhere in the item, how will that be possible..Schemes of different tyoe
How can easily apply hourly, day wise or month wise schemes on Bill, Quantity, and other schemes. Like I want to apply a scheme Form today to next 7 days .where i can mention in zoho books so scheme will implement automatically to all customers andClients not receiving emails
I've been informed that my emails are not being received. Is there anything that I should look into to rectify this? Many thanks!Free Plan mail accounts details
In the zoho mail pricing there's a free plan that includes: FREE PLAN Up to 25 Users 5GB* /User, 25MB Attachment Limit Webmail access only. Single domain hosting. I need to make sure that I'm able to create multiple email accounts in the form of: name@domain.comNo more IMAP/POP/SMTP on free plans even on referrals with NO NOTICE
Outraged. Just referred a colleague to use her domain (not posting it publicly here) to Zoho, just as I have other colleagues, clients, friends. Expected the exact same free plan features as I have and as everyone else I ever referred got. I was helpingUnable to receive email - "5.3.0 - Other mail system problem 554-'5.2.3 MailPolicy violation Error delivering to mailboxes'"
My users are unable to receive emails from one particular domain, apparently. The domain known to be kicked back is whitelisted in the spam control. I sent an email to support earlier this morning but I have not received a reply. The error in the titleCaixa de saída bloqueada. Como desbloquear?
Olá, meu e-mail isabela.celli@sivirino.com está com a caixa de saída bloqueada. Não consigo enviar e-mails. Acredito que tenha sido porque mandei o mesmo e-mail para várias pessoas, pedindo uma cotação de serviço. Vocês podem desbloquear para mim? QuantosZoho Forms - Improve the CRM integration field to query data from more than one module
Hi Forms team, Something I get stuck on regularly is pre-populating a form with data when that data is spread across 2 or 3 modules. For example Contacts, Accounts and Deals. I don't want to duplicate the information in CRM so I end up writing a functiondesbloquear cuenta
Buenos dias Cordial saludo Tengo una cuenta libre en zoho mail asociado a un dominio, pero uno de los usuarios se bloquea el correo porque dice que ha excedido el límite de correo, por favor podrian desbloquearla y como hago para que esta persona debe enviar sus correos sin ningun probleama. Gracias de antemanoNot Receiving Incoming Mail
I can send emails from my account but I do not receive any. I originally set up forwarding and it worked for a while and then stopped. I turned off forwarding and now do not receive any emails. Could you please check what is causing this issue? Thank youMaking preview pane "stick"
Hello, Is it possible to fix/dock the preview pane so that it's always there? The modern monitors are all very wide so there's plenty of space horizontally. Having the preview pane disappearing and appearing again when you click on an email message inReason:554 5.1.8 Email Outgoing Blocked
I have been struggling to set up my email address for some time now; it's difficult to locate what I need. Additionally, I cannot send or receive any emails. I keep receiving the "Reason: 554 5.1.8 Email Outgoing Blocked" error. There doesn't seem toTrouble Connecting Zoho Mail via IMAP in n8n – Need Help
Hi everyone 👋, I'm trying to connect my Zoho Mail account to n8n using the IMAP Email Trigger node, but I'm facing issues getting it to work fully. ✅ Here's what I’ve done so far: ✅ IMAP access is enabled in my Zoho Mail settings ✅ I’m using the correctUnable to send message; Reason:554 5.1.8 Email Outgoing Blocked
Hi, I sent few emails and got this: Unable to send message; Reason:554 5.1.8 Email Outgoing Blocked And now I have few days since I cant send any email. Is there something wrong I did? Also can someone fix this pleaseChanges to the send mail Deluge task in Zoho CRM
Hello everyone, At Zoho, we continuously enhance our security measures to ensure a safer experience for all users. As part of our ongoing security enhancements, we're making an important update on using the send mail Deluge task in Zoho CRM. What's changing?Page Rules in Forms
🚀 Dynamic Page Navigation Implementation I successfully implemented dynamic page navigation based on a user's radio button selection. The goal was to direct users to a specific, corresponding page while ensuring they only interact with the flow determinedCancellation of written-off invoice
Hi, Can I know when we cancel the write off (write back), in which FY, the reversal is recorded. It doesn't ask as to when the write off should be cancelled to reflect!. It shouldn't reflect in the year in which the invoice was written off since the YearCreate Invoice automated with Package
Does anyone knows how to create an invoice from a SO when we have created the package? We do these manually. and validate that the product packed is the product invoiced (if the order is partially packed) Regards, JSI want to create a mailing list, NOT a group.
Can I create a mailing list in Zoho mail? I just want to be able to make a list of email addresses and give the list a name. Then when I type the list name, the list of email addresses will be automatically listed. When I create a group it sends an emailERROR CODE :554 - Your access to this mail system has been rejected due to poor reputation of a domain used in message transfer
This message was created automatically by mail delivery software. A message that you sent could not be delivered to one or more of its recipients. This is a permanent error. *****, ERROR CODE :554 - Your access to this mail system has been rejected dueno me llegan los correos a Zoho mail
No puedo recibir correos pero sí enviarlos, ya hice la modificación de MX y la verificación de teléfonos, qué es lo que ocurre? graciasGroup Calendar as Default for adding new events, etc?
Hi, I want to make the group calendar (that I created, if that makes a difference) the default for anything new I add to the calendar. How can I do that? thanks.Bookmark Loading is Buffering
Hi, i clicked on the bookmark tab, around yesterday and since then it's been constantly buffering and doesn't allow me to access the mail's i have tried login in and out but of no help also trying to share a screenshot of the issue around 232 kb size,Zoho Webinar custom registration fields into Zoho CRM
I am pushing webinar registrations into zoho crm as leads and this is working fine. I have added a few custom fields to my webinar registration and I wish for these fields values to get mapped into the resulting CRM lead record. I am not seeing anywhereGitLab Extension for Zoho Desk: Connecting support and development for faster resolutions
Hello everyone! We’re excited to introduce the GitLab Extension for Zoho Desk, an integration that bridges the gap between support and development teams. This allows tickets to be converted into actionable GitLab issues for faster resolutions, betterDownload Google Drive Shared Image/File Using Deluge – Complete Guide
Download Google Drive Shared Image/File Using Deluge – Complete Guide When working with Google Drive share links inside Deluge, many developers face a common challenge: 👉 How can we download a Google Drive file directly using Deluge? This article explainsHow to update Acuity appointment fields from Zoho Flow?
Hi, I need help with Zoho Flow → Acuity Scheduling integration. What I’m doing Appointment created in Acuity Zoho Flow creates a Zoho Calendar event I want to send the Zoho Calendar Event UID back into Acuity (into a custom form field) This is so thatNext Page