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
Zoho Inventory - How to pay a supplier up front then receive multiple deliveries
How do we manage situations where we pay a supplier up front, then the receive the products in increments? Example Workflow: Create Purchase Order > Receive Bill for full amount > Receive Items 2 or more deliveries. Currently, once a Bill is created againstHow can I add or change the active customer in Zoho Projects?
I'm trying to change the customer in an active Zoho project. Is it possible to add or change the customer?What happens when someone clicks 'unsubscribe' in a zoho CRM email
Hello, As per, i am going round in circles trying to find an answer to these 2 question. I have an email template that has an unsubscribe link in the footer in zoho CRM. First, what happens when someone clicks it - where does the contact get unsubscribedZoho CRM - Scheduled Reports Which Contain Chart
Hi Zoho CRM Team, I'm requesting that the Report Export and Scheduling feature be enhanced to include a chart, if one has been created on a report. At the moment I have a report which shows Sales This Week by Deal Owner and a pie chart at the top of theCadences
I have just started using Cadences for follow-up up email pipeline. Is it just me or do you find the functionality very basic? For example, it will tell me (if I go looking for it) if someone has replied to a follow-up and been unenrolled; but it won'tCanvas View in Zoho Recruit
Is it possible or would it be possible to have the new 'Canvas View' in Zoho Recruit?Zoho Inventory - Move Orders
Quick question about Move Orders... Why is there no status to say something like "Draft", "In Progress" and "Completed", similar to Transfer Orders? I'm assuming that when something needs to be moved it should be planned in Inventory, executed and thenKaizen #215 - Workflow APIs - Part 3 - Create and Update Workflow Rules
Welcome back to another week of Kaizen! Over the last couple of weeks, we’ve joined Zylker Cloud Services as they review and improve their workflows. In Part 1, we discovered and audited their sprawling workflow landscape. In Part 2, we learned how toDataPrep Bigquery Connection failed
Hello everybody, I want to create a connnection beetwen Bigquery and Dataprep but when I try to connect my project I got this error Loading tables has failed. Table list fetched from the data source expired.Issue in Zoho People Regularization – Incorrect Hour Calculation
I have noticed that when applying attendance regularization in Zoho People for previous dates, the total working hours are not calculated correctly. For example, even if the check-in is 10:00 AM and check-out is 6:00 PM, the system shows an incorrectAllow Multiple usage units to items while adding them to sales/purchase transactions
The usage unit of items added in zoho books are static right now and can not be changed. But certain items are received or sold in multiple usage units. One example is fabric. It can be bought in Meters, inches, kgs or other units. Another example wouldPO receive quantities
At last, Zoho has finally got around to allowing us to receive a larger qty than recorded in the PO :-) Saves us all from editing the PO's before receiving larger quantities ( usual for us ) ! It's still in "beta" but available upon request, I've testedAnalytics : How to share to an external client ?
We have a use case where a client wants a portal so that several of his users can view dashboards that we have created for them in Zoho Analytics. They are not part of our company or Zoho One account. The clients want the ability to have user specific,Reference Deal Categories in Deluge
Hello, Is there a way to reference Deal Category in deluge functions? So for our Deals, we have several different WON stages in a pipeline. Rather than type each stage into our functions, we'd like to be able to reference the Deal Category. SimilarUsers Name & Email in Reports
Hi, I would like to show the Users Name from their Zoho Acount in All Entries/Reports as well as the current Account Email. Thanks DanWorkflow Creation with Zia gets stuck
It gets stuck here:Unable to Add Asset to Work Order Due to Different Contact and Company
Hello Zoho Team, I’m facing an issue in our environment related to asset linking in Work Orders. Here’s the situation: When our engineers go for field activities, they initially create the Work Order using the salesperson’s contact details. After completingI NEED MORE CUSTOM FIELDS!!!
Why can I only have 60 custom fields! It's not enough. I want another 100 extra custom fields to do what's necessary for my business! I'm sure I can't be the only one with this problem!!! How hard would it be to fix this? Just fix it for me please atZoho Webinar et Zapier : de la prise de rendez-vous aux relances — une automatisation performante
Organiser un webinaire réussi et gérer efficacement les participants peut être un véritable défi. Avec Zoho Webinar et Zapier, vous pouvez rendre vos processus plus simples. Vous gagnez du temps en automatisant les tâches répétitives. Résultat : une expérienceTicket Stages Report
From data to decisions: A deep dive into ticketing system reports Ticket stages refer to the series of transitions from the moment a support ticket is created until it is closed. It moves through various stages based on the actions taken at each preceding【参加無料】今年最後のZoho ユーザー交流会｜東京・大阪・名古屋で開催！ 活用事例＆ユーザー同士の情報交換
ユーザーの皆さま、こんにちは。コミュニティチームの中野です。 11月に東京、大阪、名古屋の3都市でZoho ユーザー交流会を開催します！ 毎回ご好評いただいている本イベントでは、実際の Zohoユーザーによるリアルな活用事例の共有や 参加者同士でノウハウを交換し合うグループワークを予定しています。 「他社の活用を参考にしたい」「Zoho をもっと使いこなしたい」方にぴったりの場です。 初参加の方もぜひお気軽にご参加ください！ ーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーーSlow Performance on desk.zoho.com. 11/3/2025
I’m not seeing any active service alerts for desk.zoho.com, but everyone on our account is currently experiencing very slow load times when opening or navigating tickets. We’ve already tried the standard troubleshooting steps — clearing cache and cookies,Create View to See Tickets Closed within the last 3 days
I'm trying to create a view in Zoho Desk that shows me "recently closed ticket," which I will define as tickets closed in the last 3 days. I want this view to update so that whenever I click to view it is recalculates and shows me tickets closed withinRecurring Events Not Appearing in "My Events" and therefore not syncing with Google Apps
We use the Google Sync functionality for our events, and it appears to have been working fine except: I've created a set of recurring events that I noticed were missing from my Google Apps calendar. Upon further research, it appears this is occurringDissociate account from contact
Hello, When I make the call through the API to "Dissociate account from contact" using, /api/v1/contacts/**integer**/accounts/**integer**/dissociate I get this response back, 422Unprocessable Entity (WebDAV) (RFC 4918) { "errorCode": "INVALID_DATA", "message":Zoho Desk and Zoho People Integration - is it possible in order to alert whether an agent is available
Hi, We use Zoho People for our employees to log absence (Paid Time Off etc). I was wondering if it was possible that this information can be shared in to Zoho Desk, so that when allocating a ticket to an agent, if they are on leave there is an onscreenAdd Save button to Expense form
A save button would be very helpful on the expense form. Currently there is a Save and Close button. When we want to itemize an expense, this option would be very helpful. For example, if we have a hotel expense that also has room service, which is aCall transcrition working for ringcentral?
I don't see anything about what telephony providers can be used. The Zoho support person A said that RingCentral isn't supported. Zoho support person B said that it works, just make sure the call recording link works. Excellent instructions here: CallHow to Send Email from within a custom module (with or without an email template)
It is possible to send an email from the Deals module. However, I can't find a way to send an email from any of our custom modules. I have tried adding an email field to the modules (even though we don't really want one or need it there). That doesn'tZoho Inventory - Managing Items With Multiple Suppliers
Hi community, I'm working on a project at the moment for a car parts wholesale business. Each Item (part) has its own original manufacturer part number (sometimes more than one part number for the same item). When purchasing parts from 3rd party suppliers,How do I see the total leads during a certain period?
I understand I can get the count of leads and potentials but the total number of leads in a certain period should be equal to Leads+potentials because when we convert a lead it gets moved to potentials and no longer exists there. is there a way i couldWhere is the Global Search field?
I am looking for an alternative to SF.com. Zoho CRM seems to be work fine, and be customizable in terms of the fields and reports. But there's one big thing missing and it's going to prevent us from using it: there's no global search box at the top ofKeeping start and end time logged, when using the timer
As it seems to be now: I sometimes forget to stop and restart the timer, when switching projects. And switching between projects happens upto 10 times a day. Since there's no indication to when a timer was started or stopped, I have to guess how many hours I have to remove from one project and add it to another.API 500 Error
Hello amazing ZOHO Projects Community, I get this message. How can we solve this? { "error": { "status_code": "500", "method": "GET", "instance": "/api/v3/portal/2010147XXXX/projects/2679160000003XXXX/timesheet", "title": "INTERNAL_SERVER_ERROR", "error_type":In place field editing for candidates
Wondering about any insight/best practices for efficiently updating candidate records while reviewing them in a Job Opening pipeline. We can do in-field editing (e.g. update job title or City) only when we have the full candidate record open, howeverDefault tax type for mileage?
Where we are, mileage includes a government tax. Is there any way to set a default tax for the Personal Car Mileage category of expense? (Or any other way?)Cliq File Upload
While uploading large file like 500MB, it takes time, that fines. But if you resize window or move window in other screen, that uploading disappears. After upload complete & sent it will be visibleConstant color of a legend value
It would be nice if we can set a constant color/pattern to a value when creating a chart. We would often use the same value in different graph options and I always have to copy the color that we've set to a certain value from a previous graph to makeWhat's New in Zoho POS - October 2025
Hello everyone, Welcome to Zoho POS's monthly updates, where we share our latest feature updates, releases, changes, and more. Let’s take a look at how October went. Process returns for refunds, exchanges, or offer store credit Returns and exchanges canZoho Connect Module in Zoho Trident
Hi I really like where Zoho Trident is going. Having Mail and Cliq in one place is especially powerful. However, Zoho Connect really needs to be included to make this a true communication and collaboration hub. I would like to request that Zoho ConnectNext Page