Kaizen #144 - Assigning values to different field types using Zoho CRM SDKs - Part II
Welcome to another week of our Kaizen series!
In our last week's Kaizen post, we explored the various field types in Zoho CRM and their typical uses. We also discussed the utility of our SDK sample codes available in our GitHub repositories and how they can be tailored to meet your specific needs. For effective implementation, understanding how to assign values to these different field types using the SDK is crucial, which remains our primary focus in this series.
Last week, we covered this topic using our JAVA SDK. This week, we will discuss assigning values using PHP SDK. To make sure you are all caught up, please revisit Part I before proceeding further.
2. PHP SDK
For more details, please refer to the GitHub repository for our latest PHP SDK. Check out the sample codes here.
Standard Fields:
a. Import the Field Class:
- use com\zoho\crm\api\record\{module_api_name};
b. Assign Values to Standard Fields: The syntax for assigning values to standard fields uses the addFieldValue method of the Record object:
- $record->addFieldValue({module_api_name}::{field_api_name}(), value);
Replace {module_api_name} and {field_api_name} with the appropriate values for your specific use case.
Assigning values to Standard Fields:
| Field Type JSON Type |
Assign Values | Assign Null Value |
| text (single line)
string |
$record->addFieldValue(Leads::LastName(), "Boyle"); | $record->addFieldValue(Leads::LastName(), null); |
| textarea (multiline)
string |
$record->addFieldValue(Leads::Description(), "Specify your description") | $record->addFieldValue(Leads::Description(), null); |
| email
string |
$record->addFieldValue(Leads::Email(), "abc@zoho.com"); | $record->addFieldValue(Leads::Email(), null); |
| phone
string |
$record->addFieldValue(Leads::Phone(), "91(987)654321"); | $record->addFieldValue(Leads::Phone(), null); |
| picklist
string |
$record->addFieldValue(Leads::LeadStatus(), new Choice("Not Contacted")); | -- |
| date string |
$record->addFieldValue(Products::Sales_Start_Date(), new DateTime(2024, 6, 13).Date); | $record->addFieldValue(Products::Sales_Start_Date(), null); |
| integer (number) integer |
$record->addFieldValue(Accounts::Employees(), 100); | $record->addFieldValue(Accounts::Employees(), 100); |
| currency (double)
double |
$record->addFieldValue(Leads::AnnualRevenue(), 10.00); | $record->addFieldValue(Leads::AnnualRevenue(), null); |
| boolean (checkbox) boolean | $record->addFieldValue(Leads::EmailOptOut(), true); | -- |
| website (URL) string |
$record->addFieldValue(Leads::Website(), "https://www.zoho.com"); | $record->addFieldValue(Leads::Website(), null); |
Custom Fields:
To manage custom fields using PHP SDK:
a. Import the Record Class:
- use com\zoho\crm\api\record\Record;
- $record = new Record();
b. Assign Values to Custom Fields: The syntax for assigning values to standard fields uses the AddKeyValue method of the Record object:
- $record->addKeyValue("{field_api_name}", value);
Replace {field_api_name} with the appropriate values for your specific use case.
Assigning values to Custom Fields:
Field Type JSON Type | Assign Value | Assign Null Value |
text (single line) string | $record->addKeyValue("Single_Line_Field", "Text Single Line"); | $record->addKeyValue("Single_Line_Field", null); |
textarea (multiline) string | $record->addKeyValue("Multi_Line_Field", "Text Multi Line"); | $record->addKeyValue("Multi_Line_Field", null); |
email string | $record->addKeyValue("Email_Field", "abc@zoho.com"); | $record->addKeyValue("Email_Field", null); |
phone string | $record->addKeyValue("Phone_Field", "9900000000"); | $record->addKeyValue("Phone_Field", null); |
picklist string | $record->addKeyValue("Pick_List_Field", new Choice("Option 1")); | $record->addKeyValue("Pick_List_Field", null); |
multiselectpicklist JSON array | $record->addKeyValue("Multi_Select_Field", [new Choice("Option 1"), new Choice("Option 2")]); | $record->addKeyValue("Multi_Select_Field", null); |
date string | $record->addKeyValue("Date_Field", (new \DateTime('2024-06-13'))); | $record->addKeyValue("Date_Field", null); |
datetime string | $record->addKeyValue("Date_Time_Field", date_create("2024-06-20T11:10:00+05:30")->setTimezone(new \DateTimeZone(date_default_timezone_get()))); | $record->addKeyValue("Date_Time_Field", null); |
integer (number) integer | $record->addKeyValue("Number_Field", 12); | $record->addKeyValue("Number_Field", null); |
currency (double) double | $record->addKeyValue("Currency_Field", 10.25); | $record->addKeyValue("Currency_Field", null); |
double double | $record->addKeyValue("Decimal_Field", 12.25); | $record->addKeyValue("Decimal_Field", null); |
percent double | $record->addKeyValue("Percent_Field", 12.25); | $record->addKeyValue("Percent_Field", null); |
bigint (long integer) string | $record->addKeyValue("Long_Integer_Field", "12345678"); | $record->addKeyValue("Long_Integer_Field", null); |
boolean (checkbox) boolean | $record->addKeyValue("Checkbox_Field", true); | -- |
website (URL) string | $record->addKeyValue("URL_Field", "https://www.zoho.com"); | $record->addKeyValue("URL_Field", null); |
lookup JSON Object | $account = new Record(); $account->setId("3477061000023362051"); $record->addKeyValue("Lookup_Field", $account); | $record->addKeyValue("Lookup_Field", null); |
multiselectlookup JSON array | $record1 = new Record(); $linkingRecord = new Record(); $record1->addKeyValue("id", "3477061000023362051"); $linkingRecord->addKeyValue("Multi_Select_Lookup_Field", $record1); $record->addKeyValue("Multi_Select_Lookup_Field", [$linkingRecord]); | $linkingRecord = new Record(); $linkingRecord->addKeyValue("_delete", true); $linkingRecord->addKeyValue("id", "3477061000023557067"); $record->addKeyValue("Multi_Select_Lookup_Field", [$linkingRecord]); |
userlookup JSON object | $user = new MinifiedUser(); $user->setId("3477061000005791024"); $record->addKeyValue("User_Field", $user); | $record->addKeyValue("User_Field", null); |
multiuserlookup JSON array | $record1= new Record(); $linkingRecord = new MinifiedUser(); $linkingRecord->setId("3477061000005791024"); $record1->addKeyValue("MultiUser", $linkingRecord); $record->addKeyValue("MultiUser", [$record1]); | $record1 = new Record(); $record1->addKeyValue("_delete", true); $record1->setId("3477061000023553042"); $record->addKeyValue("MultiUser", [$record1]); |
subform JSON array | $subform = new Record(); $subform->addKeyValue("Name", "SDK"); $user1 = new MinifiedUser(); $user1->setId("3477061000018959001"); $subform->addKeyValue("User_Field", $user1); $record->addKeyValue("Subform_Field", [$subform]); | $subform = new Record(); $subform->addKeyValue("_delete", true); $subform->setId("3477061000023557086"); $record->addKeyValue("Subform_Field", [$subform]); |
imageupload JSON array | $imageUpload = new ImageUpload(); $imageUpload->setFileIdS("138ef2d9af5"); $record->addKeyValue("Image_Upload", [$imageUpload]); | $imageUpload = new ImageUpload(); $imageUpload->setDelete(null); $imageUpload->setId("3477061000023579023"); $record->addKeyValue("Image_Upload", [$imageUpload]); |
fileupload JSON array | $fileDetail1 = new FileDetails(); $fileDetail1->setFileIdS("54957bcbc8fa685"); $record->addKeyValue("File_Upload", [$fileDetail1]); | $fileDetail1 = new FileDetails(); $fileDetail1->setDelete(null); $fileDetail1->setId("3477061000023551042"); $record->addKeyValue("File_Upload", [$fileDetail1]); |
multi_module_lookup JSON Object | $record1 = new Record(); $record1->setId("3477061000021552002"); $module = array(); $module["id"] = "3477061000000002179"; $module["api_name"] = "Contacts"; $record1->addKeyValue("module", $module); $record->addKeyValue("Appointment_For", $record1); | -- |
We trust this post has given you a better understanding of managing field data types in Zoho CRM using our PHP SDK. Remember that this learning does not end here. We have more posts coming up where we will explore handling field data types with our remaining SDK offerings. And do not forget to check out our Github for code samples.
As we strive for continuous improvement, we would love to hear your feedback. What topics would you like to see covered in our Kaizen series? Let us know in the comments or reach out to our support team at support@zohocrm.com.
Thank you for joining us this week. Happy coding and until next time!
Recommended Reads:
Previous Post : Assigning values to different field types using SDKs - Part I | Kaizen Collection : Home
Access your files securely from anywhere
New to Zoho Recruit?
Zoho Developer Community
New to Zoho LandingPage?
Zoho LandingPage Resources
New to Zoho Survey?
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho CRM Plus?
Deliver unforgettable customer experiences
New to Zoho Marketing Plus?
Everything you need to run your marketing
New to Zoho Marketing Plus?
Everything you need to run your marketing
New to Bigin?
Topic Participants
Anu Abraham
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 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 are
New to Zoho TeamInbox?
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.
Zoho CRM コンテンツ
-
オンラインヘルプ
-
Webセミナー
-
機能活用動画
-
よくある質問
-
Ebook
-
-
Zoho Campaigns
- Zoho サービスのWebセミナー
その他のサービス コンテンツ
Nederlandse Hulpbronnen
ご検討中の方
Recent Topics
Add Webhook Response Module to Zoho Flow
Hi Zoho Flow Team, We’d like to request a Webhook Response capability for Zoho Flow that can return a dynamic, computed reply to the original webhook caller after / during the flow runs. What exists today Zoho Flow’s webhook trigger can send custom acknowledgementsWhen moments in customer support get "spooky"
It’s Halloween again! Halloween is celebrated with spooky symbols and meanings based on history and traditions, with each region adding its own special touch. While we were kids, we would dress up in costumes along with friends, attend parties, and enjoyHow to backdate record payment for the invoice
I would like to record a payment which happened 2 days ago, but I am not able to select any date later than today. I backdated the invoice, too, but it doesn't change anythingQuestions about Zoho mail
Hello, I had up until recently, the free version. I got a warning message that said, "The user account (Redacted email address) 6.02 GB in your organization is almost nearing the allocated storage of 5.00 GB. If the storage exceeds the allowed limit,How can I delete duplicate transactions?
I want to delete the duplicates not simply exclude them. I have duplicates, because I had automatic bank feeds turned on (had to make sure this critical functionality was working before migrating to Zoho). Now when I import my csv's exported from Wave,Multiple email addresses
Multiple email addresses: I understand there is the ability to add an additional email field to a contact, but the functionality here needs to be drastically revised. Currently, this second email address does not log under the contact email history, nor is it available as a send address when using the Send Mail button within CRM. We recently migrated from GoldMine. I hate GoldMine, but there is one thing they did well: Email. I suggest copying them. Change the email field to an editable picklist,ViewID and Zoho Desk API
I'm looking at the documentation for Listing contacts and it looks like you can filter by ViewID. I assume this is views created in a department or all departments. Is this correct? And if so, how do I find the ViewID for that view? EDIT: I see the viewAbility to Link Reported Issues from Zoho Desk to Specific Tasks or Subtasks in Zoho Projects
Hi Zoho Desk Team, Hope you're doing well. When reporting a bug from Zoho Desk to Zoho Projects, we’ve noticed that it’s currently not possible to select an existing task or subtask to associate the issue with. However, when working directly inside ZohoPrint Tickets
We have field engineers who visit customers. We would like the option to print a job sheet with full details of the job and account/contact details.Zoho Desk integration with Power BI
Hi, I want to be able to create a Power BI report which has live updates of ticket data from zoho desk, is this possile at all? Thanks JackAbility to Attach Images When Reporting Issues to Zoho Projects from Zoho Desk
Hi Zoho Desk Team, Hope you’re doing well. We’re using the Zoho Desk–Zoho Projects integration to report bugs directly from support tickets into the Zoho Projects issue tracker. This integration is extremely useful and helps us maintain smooth coordinationAbility to Choose Task List and Add Subtasks When Creating Tasks from Zoho Desk
Hi Zoho Desk Team, Hope you’re doing well. We’re using the Zoho Desk–Zoho Projects integration to seamlessly connect customer tickets with project tasks. While the integration works great overall, we noticed two important limitations that affect our workflowSync Task Status from Zoho Projects to Zoho Desk
Hi Zoho Desk Team, Hope you’re doing well. We’re actively using the Zoho Desk–Zoho Projects integration, which helps our support and project teams stay aligned. However, we noticed that when we change a task’s status in Zoho Projects, the change is notDefault/Private Departments in Zoho Desk
1) How does one configure a department to be private? 2) Also, how does one change the default department? 1) On the list of my company's Zoho Departments, I see that we have a default department, but I am unable to choose which department should be default. 2) From the Zoho documentation I see that in order to create a private department, one should uncheck "Display in customer portal" on the Add Department screen. However, is there a way to change this setting after the department has been created?Zoho CRM IP Addresses to Whitelist
We were told to whitelist IP addresses from Zoho CRM. (CRM, not Zoho Mail.) What is the current list of IP Addresses to whitelist for outbound mail? Is there a website where these IP addresses are published and updated? Everything I could find is overColor of Text Box Changes
Sometimes I find the color of text boxes changed to a different color. This seems to happen when I reopen the same slide deck later. In the image that I am attaching, you see that the colors of the whole "virus," the "irology" part of "virology," andThe difference between Zoho Marketing Automation and Zoho Campaigns
Greetings Marketers! This post aims to differentiate between Zoho Marketing Automation and Zoho Campaigns. By the time you get to the end of the post, you will be able to choose a product that objectively suits you. What is Zoho Marketing Automation?Zoho Mail Android app update - View emails shared via Permalink on the app.
Hello everyone! In the latest version(v2.8.2) of the Zoho Mail Android app update, we have brought in support to access the emails shared via permalink within the app. Earlier, when you click the permalink of an email, you'll be redirected to a mobileHow to create a Zoho Mail extension similar to Outlook's OnSend add-in?
Hi, I want to create a Zoho Mail extension similar to Outlook’s OnSend add-in. The extension should: Let the user select headers and footers from a taskpane while composing an email. When the user clicks Send, the extension should: Automatically insertHow to display Motivator components in Zoho CRM home page ?
Hello, I created KPI's, games and so but I want to be able to see my KPI's and my tasks at the same time. Is this possible to display Motivator components in Zoho CRM home page ? Has someone any idea ? Thanks for your help.Introducing Record Summary: smarter insights at your fingertips
Hello everyone, We’re excited to introduce the Record Summary feature. This powerful addition makes use of Zia to simplify how you interact with your CRM data, providing a seamless, consolidated view of critical record information. Scrolling through theDelegates should be able to delete expenses
I understand the data integrity of this request. It would be nice if there was a toggle switch in the Policy setting that would allow a delegate to delete expenses from their managers account. Some managers here never touch their expense reports, andFunction #9: Copy attachments of Sales Order to Purchase Order on conversion
This week, we have written a custom function that automatically copies the attachments uploaded for a sales order to the corresponding purchase order after you convert it. Here's how to configure it in your Zoho Books organization. Custom Function: HitKaizen #8 - Handling Recurrence and Participants in the Events Module via API
Hello everyone! We are back this week with an exciting post—Handling recurrence and participants in the Events module through API. First things first—What is the Events module? "Events" is a part of the Activities module in Zoho CRM. An event is an activity that happens at a given place and time. You can find Events on the user's Zoho CRM's home page, Activities home page, Calendar, and in other related records. What are the types of Events? Events are of two types—Recurring and non-recurring events.Marketer’s Space - Get Holiday-Ready with Zoho Campaigns
Hello marketers, Welcome back to another post in Marketer’s Space! Q4 is packed with opportunities to connect with your audience - from Halloween, Black Friday, and Cyber Monday, to Thanksgiving, Christmas, and New Year. In this post, we’ll look at howPersonalized demo
can I know more about the personalized demo we are construction company andCan I collect email addresses in a form??
Can I add new subscribers to my email list (hosted in FloDesk) when they check a box and add their email address on a Zoho form?Zoho CRM Android app updates: Kiosk and multiple file upload support for subforms
Hello everyone, We've rolled out new enhancements to the Zoho CRM Android app to bring better mobile CRM experience and efficiency. Let's take a quick look at what's new: Kiosk Multiple file uploads for subforms Kiosk Kiosk is a no-code tool in Zoho CRMAlerts for mentions in comments
We are testing the use of Writer internally and found that when a user is mentioned in a comment, there is no email alert for the mention. Is this something that's configurable, and if so, where can we enable this option?Zoho Mail Android app update: Manage folders
Hello everyone! In the latest version(v2.9) of the Zoho Mail Android app update, we have brought in support for an option to manage folders. You can now create, edit, and delete folders from within the mobile app. You can also manage folders for the POPvalidation rules doesn't work in Blueprint when it is validated using function?
I have tried to create a validation rule in the deal module. it works if I try to create a deal manually or if I try to update the empty field inside a deal. but when I try to update the field via the blueprint mandatory field, it seems the validationGet Zoho Mail API working (including DRE Connector, Oauth Token, ZUID, ZOID & ACCOUNT_ID)
Disclaimer: I’m not a professional coder! Do you need to use Zoho Mail API? Me too. It lets you do all sorts of things — like reading the complete header of an email, or forwarding an email with its attachments — which is what I wanted to do. But settingRevenue Deferrals
Does ZOHO books and subscriptions handle Revenue Deferrals?Can I make a website open inside Zoho whenever I log in?
Hi Zoho Team, Every day, I check a few websites for updates, for example, Rojgar--result, where I see the latest government job results and notifications. I was wondering if there’s any option in Zoho to make a website like that open inside Zoho wheneverKaizen #214 - Workflow APIs - Part 2
Welcome back to another week of Kaizen! Last week, we discussed how Zylker Cloud Services used the Workflow APIs to discover and audit all the automations in their CRM, listing every workflow, checking triggers, and understanding their automation limits.Zoho CRM Community Digest - September 2025 | Part 1
Hello Everyone! September's Here! Before we jump into product updates, and community highlights, here's a quick spotlight! Zoho has launched a Professional Sales Rep Certification course on Coursera, tailored for sales professionals to strengthen theirUpload my theme.
Hello. I would like to upload my own theme, this one: https://themeforest.net/item/panagea-travel-and-tours-listings-template/21957086 Is it compatible and where I upload it? If not I will hire a developer, what do I have to ask when I search for one?Product Updates in Zoho Workplace applications | September 2025
Hello Workplace Community, Let’s take a look at the new features and enhancements that went live across all Workplace applications this September. Zoho Mail Attach email as EML file in Compose Effortlessly attach emails as EML file in Compose by simplyVehicle Tracking
we have GPS devices that installed on our vehicles, and we would like to know if it's possible to get vehicle live location data from the GPS device To Zoho Creator App. Thank You🤝 Rencontres, partage et inspiration au Zoho Community Meetup de novembre
Chers utilisateurs, Bonne nouvelle 🎉 : notre Meetup Zoho Community approche, et nous serions ravis de vous y voir ! 📍 Toulouse : le 25 novembre 📍 Lyon : le 27 novembre (🎯 Il ne reste que quelques places !) Que vous soyez débutant ou utilisateur avancé,Next Page