Map Dependency Fields in Zoho CRM using APIs
Map dependency fields with a use case
- Parent Field - Issue Type: The value chosen here determines which options appear in the dependent field.
- Child Field - Sub-Issue: The available options change dynamically based on the selected value in the parent field.
Issue Type | Sub-Issue |
Login Issue | Forgot Password, Account Locked, 2FA Not Working |
Payment Issue | Credit Card Declined, Refund Not Received, Double Charge |
Feature Request | New Integration, UI Enhancement, Report Customization |
Without map dependency
Without configuring a map dependency, the Sub-Issue picklist would always display all available options - regardless of the selected Issue Type. For example, users might see options like Forgot Password, Double Charge, and Report Customization all at once. This can easily confuse users and lead to incorrect selections, such as choosing Double Charge under Login Issue.With map dependency
With mapping dependencies, you can guide users to make correct selections by showing only the relevant options in the child field based on the option selected in the parent field.Mapping picklist options in UI
- Go to Setup → Customization → Modules and Fields.
- Select the desired module. In this case, Support Cases.
- Click the ⋯ (more) icon next to the module name.
- Select Map Dependency Fields.
- On the Map Dependency Fields page, click the New button to create a new dependency.
- Choose the Parent Field and Child Field you want to map.
- Click Next button.
UI options mapping viewMapping picklist options via API
- Modules Metadata API - To know the API name of the module.
- Endpoint: GET - /settings/modules
- Here, the API name of the Support Cases module is Support_Cases.
- Layouts Metadata API - Since dependencies are layout-specific, this API helps you identify the layout ID and all the available picklist fields for mapping. It also provides detailed metadata such as the layout ID, field IDs, and the corresponding picklist value IDs.
- Endpoint: GET /settings/layouts?module=Support_Cases
Create Dependency using the POST Map Dependency
{ "map_dependency": [ //Array that contains one or more dependency mappings { "parent": { // Mandatory - Represents the parent picklist "api_name": "Issue_Type", //Mandatory - API name of the parent field "id": "5725767000007985243" // Mandatory - Unique ID of the parent picklist }, "pick_list_values": [ //Mandatory - List of parent picklist values and their corresponding child mappings { "display_value": "-None-", "maps": [ { "display_value": "-None-", "actual_value": "-None-", "id": "5725767000007985204" } ], "actual_value": "-None-", "id": "5725767000007985249" }, { "display_value": "Login Issue", "maps": [ { "display_value": "Forgot Password", //Label shown in the UI for the parent value "actual_value": "Forgot Password", //Actual stored value of the parent picklist option "id": "5725767000007985185" //Mandatory - Unique ID of the parent picklist option }, { "display_value": "Account Locked", "actual_value": "Account Locked", "id": "5725767000007985187" }
], "actual_value": "Login Issue", //Actual value of the parent field's option "id": "5725767000007985242" //Mandatory - Unique ID of the parent field's option }, { "display_value": "Payment Issue", "maps": [ { "display_value": "Credit Card Declined", "actual_value": "Credit Card Declined", "id": "5725767000007985191" }, { "display_value": "Refund Not Received", "actual_value": "Refund Not Received", "id": "5725767000007985193" }, { "display_value": "Double Charge", "actual_value": "Double Charge", "id": "5725767000007985195" } ], "actual_value": "Payment Issue", "id": "5725767000007985244" }, { "display_value": "Feature Request", "maps": [ { "display_value": "New Integration", "actual_value": "New Integration", "id": "5725767000007985197" }, { "display_value": "UI Enhancement", "actual_value": "UI Enhancement", "id": "5725767000007985199" }, { "display_value": "Report Customization", "actual_value": "Report Customization", "id": "5725767000007985201" } ], "actual_value": "Feature Request", "id": "5725767000007985246" } ], "child": { //Mandatory - Represents the child field "api_name": "Sub_Issue", //Mandatory - API name of the child field "id": "5725767000007985186" //Mandatory - Child picklist field ID } } ] } |
{ "map_dependency": [ { "code": "SUCCESS", "details": { "id": "5725767000008174001" }, "message": "map dependency created", "status": "success" } ] } |
Retrieve the configured field mappings using the GET Mapped Dependency Fields API
{ "map_dependency": [ { "parent": { "api_name": "Issue_Type", "id": "5725767000007985243" }, "internal": false, "active": true, "id": "5725767000008180001", "source": 1, "category": 0, "pick_list_values": [ { "display_value": "-None-", "maps": [ { "display_value": "-None-", "actual_value": "-None-", "id": "5725767000007985204" } ], "actual_value": "-None-", "id": "5725767000007985249" }, { "display_value": "Login Issue", "maps": [ { "display_value": "Forgot Password", "actual_value": "Forgot Password", "id": "5725767000007985185" }, { "display_value": "Account Locked", "actual_value": "Account Locked", "id": "5725767000007985187" }, { "display_value": "2FA Not Working", "actual_value": "2FA Not Working", "id": "5725767000007985189" } ], "actual_value": "Login Issue", "id": "5725767000007985242" }, . . . ], "child": { "api_name": "Sub_Issue", "id": "5725767000007985186" } } ] } |
Update the existing mapped options using the PUT Mapped Dependency Fields API
{ "map_dependency": [ { "parent": { "api_name": "Issue_Type", "id": "5725767000007985243" }, "pick_list_values": [ { "display_value": "-None-", "maps": [ { "display_value": "Login Issue", "maps": [ { "display_value": "Forgot Password", "actual_value": "Forgot Password", "id": "5725767000007985185" }, { "display_value": "Account Locked", "actual_value": "Account Locked", "id": "5725767000007985187" }, { // mapped a new option to the existing mapping "display_value": "2FA Not Working", "actual_value": "2FA Not Working", "id": "5725767000007985189" } ], "actual_value": "Login Issue", "id": "5725767000007985242" } ], "child": { "api_name": "Sub_Issue", "id": "5725767000007985186" } } ] } |
Delete existing dependency using the DELETE Mapped Dependency Fields API
{ "map_dependency": [ { "code": "SUCCESS", "details": { "id": "5725767000008174001" }, "message": "map dependency deleted", "status": "success" } ] } |
Assigning picklist values using the Insert Records API
{ "data" : [ { "Name" : "Support Case 1", "Support_Case" : "Login Issue", "Issue_Type" : "Login Issue", "Sub_Issue":"Forgot Password" } ] } |
FAQs
- Map picklists within the main form, or
- Map picklists within the same subform.
Access your files securely from anywhere
Zoho Developer Community
Topic Participants
Subramanian K
Sticky Posts
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 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 achievedKaizen #142: How to Navigate to Another Page in Zoho CRM using Client Script
Hello everyone! Welcome back to another exciting Kaizen post. In this post, let us see how you can you navigate to different Pages using Client Script. In this Kaizen post, Need to Navigate to different Pages Client Script ZDKs related to navigation A.Kaizen #210 - Answering your Questions | Event Management System using ZDK CLI
Hello Everyone, Welcome back to yet another post in the Kaizen Series! As you already may know, for the Kaizen #200 milestone, we asked for your feedback and many of you suggested topics for us to discuss. We have been writing on these topics over the
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
Design. Discuss. Deliver.
Zoho Show Resources
Get Started. Write Away!
Writer is a powerful online word processor, designed for collaborative work.
-
オンラインヘルプ
-
Webセミナー
-
機能活用動画
-
よくある質問
-
Ebook
-
-
Zoho Campaigns
- Zoho サービスのWebセミナー
その他のサービス コンテンツ
Nederlandse Hulpbronnen
ご検討中の方
Recent Topics
All new Address Field in Zoho CRM: maintain structured and accurate address inputs
The address field will be available exclusively for IN DC users. We'll keep you updated on the DC-specific rollout soon. It's currently available for all new sign-ups and for existing Zoho CRM orgs which are in the Professional edition. Latest updateCopy, Paste, Highlighted text
when i copy paste text it gets highlighted. Fix this. WTF is with this black highlight ? Fix copy pasting. Some people pay for using this mail service.Pricing Strategies: #6 Common Mistakes while Configuring Pricing
"Why does this month's billing feel messy again?" That was the exact line Priya muttered while staring at the spreadsheet full of edited pricing, one-off discounts and mismatched subscription details. Her business was growing, but the pricing machinePublish to LinkedIn via API
Hi, Is it possible to publish a job opening to LinkedIn (paid job slots) if creating a job opening via api / deluge function? Or is the user required to manually publish via the job boards process? Many Thanks AdrianFuture Orders - Due Date
Hi In my role, I can receive tickets where the work required is requested months in advance. Using a Future Orders option, which I believe was setup under the On Hold status type, hides the Due Date, in all views/ticket etc. Whilst I understand the reasoningFSM - Associating and selecting Contacts based on Service Addresses
Hi FSM team, I've come across an FSM limitation I wanted to share for improvement. I'm currently configuring FSM for a client who provides heating system install and maintenance services. The are often sub contracted by building management companies to日本語フォントの選択肢拡充についての要望
日本語フォントの選択肢がとても少ないと感じたことはありませんか？ 多くのアプリ（たとえば Invoice）ではフォントが1種類しかなく、正直あまり使いやすい・見た目が良いとも言えません。 そろそろ、もっと多くの日本語フォントを追加してほしい、そしてすべてのアプリで同じフォント選択肢を使えるようにしてほしいと、私たちユーザーが声を上げる時期だと思います。 ご存じのとおり、現状ではアプリごとにフォント周りの仕様にほとんど一貫性がありません。 みなさん、一緒に要望を出していきましょう！Do Unpublished Products in Shopify Sync to Zoho POS?
Will an unpublished product in Shopify sync to Zoho POS? I would like to know how Zoho POS handles products that are in draft/unpublished status in Shopify.Problem in Zoho POS frontend ERP.
We are facing some difficulties in our billing and inventory processes and require your support to resolve them at the earliest. Customer Advance Payments We receive advance payments from customers for upcoming sales. Please guide us on how to recordHow to create estimates/Invoices with sub-totals
Every other accounting package can create estimates and invoices with Sub-totals. How can I do that in ZohoBooks?Categorize Items with Item Headers
Hello customers, Did you ever want to classify items based on specific categories to help your customers understand your invoice better? With the new Item Header feature, you can easily categorize items in your invoices and estimates and give them a common title. Item Headers are available in the Invoices, the Recurring Invoices and the Estimates module. It can be carried forward from estimates to invoices at the time of converting the estimates. To add an item header: Go to the Estimates, InvoicesItem/service subtotal
Just discovered & really pleased that we can drag to re-order the line items in Sales orders & Invoices, a very nice feature which doesn't seem to be documented? It would be nice to be able to insert a subtotal as a line item to complete this great featureEmails sent through Bigin are not posting in IMAP Sent folder
I have set up my email to work from within Bigin using IMAP. I am using IMAP so I can sync my email across multiple devices - phone / laptop / desktop / iPad / etc. I want all my emails to populate my email client (outlook & iphone email) whether orAsk the Experts 26: Brighten every customer interaction with Zoho Desk all year long
Hello everyone, Greetings and welcome to Ask the Experts 26. As we wrap up 2025, we are excited to invite you to the 26th episode of our Ask the Expert series. 🎄The Merry Metrics Edition = Best of Zoho Desk [Best Practices + Holiday Automation + Year-EndPainfully Slow Zoho mail
Since yesterday Zoho Mail seems to have starting functioning very slowly and having a few bugs. It's slow to open mails, slow to send, slow to change between email accounts. Sometimes clicking on a particular folder (eg Sent folder) stops working andStudy in Netherlands for International Students – Admission, Costs, Visa & Experience
Dutch university fees are an important factor for anyone planning to study in Netherlands, especially international students comparing costs across Europe. Tuition varies depending on nationality, program type, and whether you choose a research universityGPS tracking only or Check out facility
Dear Team, Zoho CRM is quite robust CRM but till date i was waiting for the feature of having GPS tracking of Sales employees which is a common demand by all customers for thier field sales executives. We cover them by saying that CRM provides CheckinCan I use a Standalone CRM Function as the Callback URL For Async Export Data API?
I am creating an export job using this API https://www.zoho.com/analytics/api/v2/bulk-api/export-data-async/create-export/view-id.html There is a "callbackUrl" key in the CONFIG object. I tried copying the URL for a standalone function in CRM which canDiscount on the transaction level in POS
"Is it possible to apply a discount on the total bill before tax in Zoho POS?" I want to apply a discount on the total transaction amount in Zoho POS, but the discount should be calculated before the taxes are applied. Is there an option to do this inZoho DataPrep switching Date Format
When using a pipeline that is importing Zoho Analytics data into Zoho DataPrep, the month and day of date fields are switched for some columns. For example, a Zoho Analytics record of "Nov. 8, 2025" will appear in Zoho DataPrep as "2025/08/11" in "yyyy/MM/dd"Create Tasklist with Tasklist Template using API v3
In the old API, we could mention the parameter 'task_template_id' when creating a tasklist via API to apply a tasklist template: https://www.zoho.com/projects/help/rest-api/tasklists-api.html#create-tasklist In API v3 there does not seem to be a way toIntroducing Dedicated Modules for Plans, Addons, and Coupons in Zoho Billing
We’ve enhanced the way you manage Plans, Addons, and Coupons in Zoho Billing. Previously, all three grouped together under Subscription Items. Now, each one has its own dedicated module, giving you a cleaner and more intuitive experience. This updateSend Automated WhatsApp Messages and Leverage the Improved WhatsApp Templates
Greetings, I hope all of you are doing well. We're excited to announce a major upgrade to Bigin's WhatsApp integration that brings more flexibility, interactivity, and automation to your customer messaging. WhatsApp message automation You can now useConverting Sales Order to Purchase Order
Hi All, Firstly, this code works to convert a sales order(SO) to a purchase order (PO) via a button, however I am running into an issue when I convert the SO where the values from the line items are not pulled across from the SO to the PO. The ones inGain control over record sharing with portal users through our new enhancement: criteria-based data exposure
Dear Customers, We hope you're well! Portals is a self-service avenue through which your clients can access and manage their direct and related data in Zoho CRM. This empowers them to be more independent and enables them to experience a sense of transparencyJobs at multiple locations
Hi A lot of times we have same job open at multiple locations. So I would like an option where we can create a job and choose multiple locations. Currently we have to create individual jobs for each location. If we can create one job and mention multipleFrom Zoho CRM to Paper : Design & Print Data Directly using Canvas Print View
Hello Everyone, We are excited to announce a new addition to your Canvas in Zoho CRM - Print View. Canvas print view helps you transform your custom CRM layouts into print-ready documents, so you can bring your digital data to the physical world withPassing the CRM
Hi, I am hoping someone can help. I have a zoho form that has a CRM lookup field. I was hoping to send this to my publicly to clients via a text message and the form then attaches the signed form back to the custom module. This work absolutely fine whenTag Adding Option in Kanban Card Customization Bigin CRM Mobile App
I would like to request an option to add and display tags on Kanban cards in the Bigin CRM mobile app. This feature would make it easier to categorize deals and quickly identify priorities while working on the go.Empowered Custom Views: Cross-Module Criteria Now Supported in Zoho CRM
Hello everyone, We’re excited to introduce cross-module criteria support in custom views! Custom views provide personalized perspectives on your data and that you can save for future use. You can share these views with all users or specific individualsCanva Integration
Hello! As many marketing departments are streamlining their teams, many have begun utilizing Canva for all design mockups and approvals prior to its integration into Marketing automation software. While Zoho Social has this integration already accomplished,Ticket Status email
Good day, This was discussed in the past, but it would be helpful if we could have the system assign a custom response to a status. We have various statuses for tickets, e.g. "closed due to no response", or "Pending Status", it would be helpful for theWhatsApp Voice Message Sending Option in Bigin CRM
I would like to request a feature that allows users to send WhatsApp voice messages directly from Bigin CRM. This would help improve communication efficiency and make it easier for teams to respond quickly to customer inquiries.CRM: hosting a single html file in Zoho and displaying it as a widget
I have seen that CRM offers the option of uploading a web project to Zoho itself and displaying it as a widget in CRM. The instructions then talk about setting a development environment with Node and developing an application to upload to Zoho. But ISynchronise item image between Zoho Commerce and Zoho Books/Inventory/CRM
Here is a blindingly simple idea to tie several Zoho products together. Zoho - please include a method to synchronise the item image (or images) from one Zoho application to another. For example, if you upload an item image in Zoho Inventory, a user shouldHow to change position button transtition of Blueprint?
Hi Everyone, Look at my screenshoot, it is possible move the reject button to the right? I couldn't find that setting in the blueprint. Thank you.Marketer’s Space - WhatsApp Pricing Update: What Marketers Need to Know and Do
Hello Marketers, Welcome back to Marketer’s Space! WhatsApp made changes to their pricing model on July 1, 2025, moving from conversation-based pricing to a per-message pricing model. This week’s post focuses on what these changes mean for your WhatsAppZoho Desk Limitations
Good day, all, I would like to know whether others share my frustration with some of Zoho's limitations. Don't get me wrong, I like Desk (and I also have a subscription for Analytics), I have been with them for close to 10 years, and unfortunately, IMulti file upload
Hi, I just wonder if one could upload multiple files in one shot, say between one and three files, without adding multiple File Upload fields? Thanks, AlalbanySorting Descending in a lookup
I have a case number lookup on multiple forms. I need the most recent added to appear at the top of the lookup or as the list of cases grom it's too much to scroll. Is there a way to have a look up sort descending?Next Page