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
Conditional formatting based on another field
Hi I have two fields on my form stage 1 complete and stage 1 deadline. I am trying to setup conditional formatting so that if stage 1 complete is after stage 1 deadline the record is highlighted in red. I need both stage 1 complete and stage 1 deadlineThe sending IP (136.143.188.15) is listed on spamrl.com as a source of spam.
Hi, it just two day when i am using zoho mail for my business domain, today i was sending email and found that message "The sending IP (136.143.188.15) is listed on https://spamrl.com as a source of spam" I hope to know how this will affect the deliveryChanging a Single-Line Text field into a Multi-line Field without losing data
Is it possible to change a Single-Line Text field into a Multi-line Field without losing data. I have a module with data for which I would like to change a single-line field into a multi-line field but I'm worried it might delete the pre-existing daWebhook - Google Sheets
I have 2 forms that are both integrated with Google Sheets. I've set up a webhook to pull form 1 data from Google Sheets to prefill data in Form 2. The issue I have is that the forms name fields are First Name & Last Name but the Google sheets integrationVerified Mark Certificate
Hello Dears, Can anyone help and check my mail or direct me to the desired person who can add the verification tag to my mail https://www.zoho.com/blog/mail/email-authentication-with-bimi.htmlAppointment booking is temporarily unavailable
Embeded Zoho booking page in my WordPress website. When someone starts a booking, after choosing time and date, an error appears before payment - "Appointment booking is temporarily unavailable due to restricted settings." Used the embeded code givenCannot connect to 365 business calendar and Teams, says personal but it is not.
hi I have a number of users connected to their 365 business accounts. Adding a new user and it thinks hes got 365 personal edition. He does not.... Anyone know what's going on. Trying for days now. Bookings go into his MS calendar but as its thinks itsLimited review (/questions) for Bookings 2.0
Hi all, I'm writing this review of Bookings 2.0 for two reasons: 1) it may be of interest to others, and 2) I'd like to be corrected if I'm wrong on any points. It's a very limited review, i.e. the things that have stood out as relevant, and particularlyZoho Bookings - Reserve with Google
Does Zoho Bookings plan to to integrate with Reserve with Google?Tip #3: How to change your booking page language
Displaying your booking page in your target audience's language can greatly increase customer satisfaction. By speaking their language, you will help customers feel more comfortable scheduling with you and create a stronger connection with them. Let'sBigin Android app update: Alerts while creating tasks outside of working days, conflicting events and calls.
Hello everyone! In the most recent version of the Bigin Android app, we have brought in support to display an alert if task is being scheduled outside of the working days. Also, when scheduling an event or call in the Activities module, a conflict alertBigin update: Link email messages to pipeline records.
Hello everyone! In the latest version of the Bigin iOS(v1.11.9) and macOS(1.8.9) app, we have brought in support for an option to link email to pipeline records. This helps you to view emails specific to a deal, especially when a contact is associatedBigin Android app update: Custom buttons and widgets
Hello everyone! We are excited to introduce custom buttons and widgets on the Bigin Android app. Widgets: A widget is a customizable UI component in Bigin that improves efficiency and user experience. It lets businesses embed components, streamline interactions,Collective-booking event not added to all staff calendars
We assign two staff to certain events. When the client books this event, it adds it to one staff calendar (the 'organiser') but not the other. How can I ensure all staff assigned to a collective booking get the event in their calendar? (A side note: itProject Management Bulletin: October, 2025
Every need leads to innovation. Project Management tools were developed out of sheer necessity to drive large projects. With wide usage, the specifications grew precise, and so did the refinement. Over years we’ve crafted one of the best project managementZoho Sheets saying locked when not locked
Zoho Sheets won't let me add more rows to sheet because it's saying the sheet is locked, but the sheet is not locked. I tried using a different browser but I still have the same issue.Identifying and Merging Accounts with Similar (Non-Exact) Names
Hello everyone, I’m aware of the built-in deduplication feature in Zoho CRM that allows merging records with exactly matching values for selected fields. However, I’m running into a situation where our migrated data contains multiple variations of theOption for super admin to recover the deleted chats in Zoho Cliq
Currently, in Zoho Cliq, if a user accidentally deletes their chats, there is no option for the Super Admin to recover or view those deleted messages. I believe it would be helpful if Super Admins had a recovery option, perhaps within a certain time frame,Zoho CRM iOS app updates: the Homepage, Zoho Survey integration, and support for multiple file uploads in subform
Hello everyone! The Zoho CRM mobile app continues to evolve to bring you a smoother and more powerful CRM-on-the-go experience. We're excited to share some important updates now available in the iOS app. Here's what's new: Homepage support Zoho SurveyI am trying to integrate my module in sandbox environment to add data via API
I went through the documents and tried to setup the API for adding the module via the api but the problem is the token setup is done on "https://accounts.zoho.in/oauth/v2/token" domain and the bulk write is done on "https://content.zohoapis.com/crm/v8/upload"Setting up primary mobile number.
Hi Sir Earlier I joined IIFL team and got an organizational email of zoho services. Later i quit and now my account is deactivated with IIFL but i am unable to link my mobile number to my own email id with zoho.Tables for Europe Datacenter customers?
It's been over a year now for the launch of Zoho Tables - and still not available für EU DC customers. When will it be available?Guided Conversations - Ticket Creation
Hi there, Using Guided Conversations to Take Customer Data and apply it into a Support Ticket for internal use, Is there a way to take multiple Textual Variables Inputs (A series of questions), and have the answers all appear in the Description of theHow to send certain invoices for Approval based on condition?
To streamline operations, I need the invoices to go for approval when certain conditions are met. For example, if my staff gives a discount of x amount, it must go for approval. If there is no discount, then the invoice will be approved automatically.Unable to continue payment
Hi, I want to make a payment for my email subscription, but I cannot proceed with the payment because my NITKU is invalid. In Indonesia, the NITKU consists of 22 digits, but Zoho only provides 20 digits, causing my NITKU to be invalid. Please help meIs there a way to show contact emails in the Account?
I know I can see the emails I have sent and received on a Contact detail view, but I want to be able to see all the emails that have been sent and received between all an Accounts Contacts on the Account Detail view. That way when I see the Account detailMassive spam pretending to come from our address – is this a Zoho security issue?
Hi, We’ve been receiving more and more suspicious emails lately — many of them clearly look like scams. But yesterday, we got an email that appeared to be sent from our own address, which was very concerning. We're starting to wonder if this might beCant recieve mails
I’m having an issue with my external IMAP account not fetching any emails into Zoho Mail, even though the connection test says “Success”. I can send, if someone sends an email to me. my original directory (home.pl host) recieves it in their portal butZoho Sheet Autofit Data
While using Autofit Data function in Zoho Sheets with Devnagri Maratji or Hindi Fonts, a word or a number, it keeps couple of characters outside the right side border.Enhancements to finance suite integrations
Update on the migration (October 28, 2025): Starting this week (October 29 tentatively), we’ll begin migrating Zoho CRM users to Zoho Books as integration users. This means actions will now run under each user’s own Zoho Books access, instead of the admin’s.Edit 'my' Notes only
The permissions around Notes should be more granular, and allow to user to be able to edit the notes he created only. The edit Notes permission is useful as it allows the user to correct any mistakes or add information as needed. However, with this sameJob Alerts for Candidates
hi All, I have 2 questions relating to sharing job details with candidates. 1. is there a way to notify candidates that meet certain criteria of current jobs available? eg. I run a candidate search, and identify 50 candidates that might be suitable. CanEnhancing Task Accuracy: Automatically notify the owners upon Task duplication.
Hello Everyone, A Custom function is a user-written set of code to achieve a specific requirement. Set the required conditions needed as when to trigger using the Workflow rules (be it Tasks / Project) and associate the custom function to it. The requirementNodemailer not working with Zoho
Hi All, I'm having issues with Zoho working with Nodemailer. It works as expected when using gmail as the service. Below is the code I get when using zoho. Error sending email: Error: connect ECONNREFUSED 127.0.0.1:587 at TCPConnectWrap.afterConnect [asdesktop app for TODO
Is there a desktop app for Zoho TODO?Show/ hide specific field based on user
Can someone please help me with a client script to achieve the following? I've already tried a couple of different scripts I've found on here (updating to match my details etc...) but none of them seem to work. No errors flagged in the codes, it justWhere are Kanban swimlanes
So i've been playing with Zoho Projects Kanban view a bit more. It appears that task lists are being used as the Kanban columns, which makes sense from the implementation point of view but not the logical one. Kanban columns are statuses that a task can flow through, while a task list has been a logical way to organize related tasks and relate them to a mislestone. In other words a task in a particular task can go through several stages while remaining in the same task list. After doing some researchTip 19: How to display images in Pages using ZML snippets
Hi folks, We're back with another tip on how to use Zoho Markup Language (ZML) to create interactive pages in Zoho Creator. You can use ZML snippets to add various kinds of components to your pages and structure them in meaningful ways. That's not all, though—using ZML you can ensure your application is automatically compatible with all kinds of devices without any inconsistencies. We often get questions from users about how to invoke Deluge scripts within ZML code. Here's a simple use case for addingCan zoho swign format block text spacing automatically when prefilled from zoho crm?
I'm sending zoho sign template from zoho crm, so that zoho crm pre-populates most fields. I have existing pdf documents that i am having signed. I have no ability to change the pdf documents, they are standardized government forms. The problem I am facingReference lookup field values in Client script
hello all, I'm using a "ZDK.Apps.CRM.Products.searchByCriteria" function call, which is returning the matching records correctly; however, one of the fields is a lookup field which I need the associated data. I believe there is a way to get this dataNext Page