ZohoCRM API V2 /w PHP SDK 3 - INVALID MODULE

ZohoCRM API V2 /w PHP SDK 3 - INVALID MODULE

I'm trying to add a SalesOrder to Zoho CRM via the PHP SDK3.
So far I have Zoho connecting, and I have successfully created a "Lead" based on the sample code. Now I am trying to get a SalesOrder created in the system but am hitting the exception:


API_EXCEPTION - {"code":"INVALID_MODULE","status":"error","message":"the module name given seems to be invalid"}


Here is the code I am using:

  1. <?php

    use com\zoho\crm\api\util\Constants;
    use com\zoho\crm\api\record\RecordOperations;
    use com\zoho\crm\api\record\Record;
    use com\zoho\crm\api\record\Field;
    use com\zoho\crm\api\record\Sales_Orders;
    use com\zoho\crm\api\record\Leads;
    use com\zoho\crm\api\record\Accounts;
    use com\zoho\crm\api\record\Events;
    use com\zoho\crm\api\record\BodyWrapper;
    use com\zoho\crm\api\tags\Tag;
    use com\zoho\crm\api\record\InventoryLineItems;
    use com\zoho\crm\api\record\LineItemProduct;

    function insertSalesOrder() {
    echo "<br/>insertSalesOrder...<br/>";

    $moduleAPIName = Constants::SALESORDERS; //"Sales Orders"; //"salesorders"; //Constants::SALESORDERS;

    echo $moduleAPIName;

    //Get instance of RecordOperations Class that takes moduleAPIName as parameter
    $recordOperations = new RecordOperations();
    //Get instance of BodyWrapper Class that will contain the request body
    $bodyWrapper = new BodyWrapper();
    //List of Record instances
    $records = array();
    //$recordClass = 'com\zoho\crm\api\record\Record';
    //Get instance of Record Class
    $record1 = new Record(); //$recordClass();
    /*
    * Call addFieldValue method that takes two arguments
    * 1 -> Call Field "." and choose the module from the displayed list and press "." and choose the field name from the displayed list.
    * 2 -> Value
    */
    $field = new Field("");
    //$record1->addFieldValue(Leads::LastName(), "TEST FROm PHP");

    $record1->addFieldValue(Sales_Orders::Subject(), "TEST FROm PHP subject");
    //$record1->addFieldValue(Sales_Orders::ProductDetails(), "TEST FROm PHP product details");
    $record1->addFieldValue(Accounts::AccountName(), "Account_Name");

    $productId = '3194657000031371025'; // grabbed form url: https://crm.zoho.com/crm/org665997644/tab/Products/3194657000031371025
    //$lineItem = new InventoryLineItems();
    //$lineItem->setDescription("test product description");
    //$lineItem->setDiscount(5);
    //$lineItem->setListPrice(100);

    $inventoryLineItemList = array();
    $inventoryLineItem = new InventoryLineItems();

    $lineItemProduct = new LineItemProduct();
    $lineItemProduct->setId($productId); //"3477061000005356009");
    $inventoryLineItem->setProduct($lineItemProduct);
    $inventoryLineItem->setQuantity(1.5);
    $inventoryLineItem->setProductDescription("productDescription");
    $inventoryLineItem->setListPrice(10.0);
    $inventoryLineItem->setDiscount("5.0");
    $inventoryLineItem->setDiscount("5.25%");
    /*
    $lineItemProduct = new LineItemProduct();
    $lineItemProduct->setId($productId); //"34770615356009");
    $inventoryLineItem->addKeyValue("Product_Name", $lineItemProduct);
    $inventoryLineItem->addKeyValue("Quantity", 1.5);
    $inventoryLineItem->addKeyValue("Description", "productDescription");
    $inventoryLineItem->addKeyValue("ListPrice", 10.0);
    $inventoryLineItem->addKeyValue("Discount", "5%");
    */
    //$record1->addLineItem($lineItem);

    array_push($inventoryLineItemList, $inventoryLineItem);
    $record1->addKeyValue("Product_Details", $inventoryLineItemList);

    /*
    $record1->addKeyValue("Date_1", new \DateTime('2021-03-08'));
    $record1->addKeyValue("Date_Time_2", date_create("2020-06-02T11:03:06+05:30")->setTimezone(new \DateTimeZone(date_default_timezone_get())));
    $startdatetime = date_create("2020-06-02T11:03:06+05:30")->setTimezone(new \DateTimeZone(date_default_timezone_get()));
    $record1->addFieldValue(Events::StartDateTime(), $startdatetime);
    $record1->addFieldValue(Events::EventTitle(), "TEST From PHP");
    $enddatetime = date_create("2020-07-02T11:03:06+05:30")->setTimezone(new \DateTimeZone(date_default_timezone_get()));
    $record1->addFieldValue(Events::EndDateTime(), $enddatetime);
    $tagList = array();
    $tag = new Tag();
    $tag->setName("Testtask");
    array_push($tagList, $tag);
    //Set the list to Tags in Record instance
    $record1->setTag($tagList);
    */
    array_push($records, $record1); // pushing the record to the array

    $bodyWrapper->setData($records);
    $trigger = array("approval", "workflow", "blueprint");
    $bodyWrapper->setTrigger($trigger);
    $response = $recordOperations->createRecords($moduleAPIName,$bodyWrapper);

    echo "<br/>RESPONSE:<br/>";
    echo print_r($response);
    }



I've also tried calling getModules API and it is showing me there is a SalesOrder module name.

Can anyone help which might be wrong?



      • 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 this

      • Kaizen #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 how

      • 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 are

        • Recent Topics

        • Best practice to handle 50+ invokeurl calls in a loop without hitting the 30-second timeout?

          Hi everyone, I am working on a custom Deluge function where I have a Map containing around 50+ key-value pairs. I need to iterate through this Map using a for each loop and make a GET API call (invokeurl) for each item. The Problem: Because of the 50+

        • How to list WorkDrive folder contents using API

          I'm trying to read folder contents using a Deluge script. The code below returns {"errors":[{"id":"F6016","title":"URL Rule is not configured"}]}". I've tried using the search API and seen similar errors. I have proved that the connection works by creating

        • filter on sheets mobile (iOS, iPadOS) does not work

          re-posting this as a question because reporting as a problem netted zero responses... I have this issue on every spreadsheet, whether imported or created natively in Zoho Sheets. I can use on desktop without issue: but on iOS the filter dropdowns are

        • Solving the bug in Zoho Writer API for styling

          So... the Zoho Writer APIs for programatically creating a document do not respect a template's style. The result is that any document you generate via API needs to be manually, paragraph by paragraph, reformatted. That bug alone is sufficient to render

        • Zoho Books' 2025 Wrapped

          Before we turn the page to a new year, it’s time to revisit the updates that made financial management simpler and more intuitive. This annual roundup brings together the most impactful features and enhancements we delivered in 2025, offering a clear

        • Speed (again!)

          Same old story again: impossible to work at this "speed". Category NOTES!

        • Need to set workflow or journey wait time (time delay) in minutes, not hours

          Minimum wait time for both Campaigns workflows and Marketing Automation journeys is one hour. I need one or the other to be set to several minutes (fraction of the hour). I tried to solve this by entering a fraction but the wait time data type is an integer

        • sending email with another account

          Hello there, i write there for an our costumer request. They want to send email from CRM with a different email (confirmed and added to zoho profile). For example they use account@zilium.com but with this account they want to send (not only with email

        • All new Address Field in Zoho CRM: maintain structured and accurate address inputs

          Availability Update: 29 September 2025: It's currently available for all new sign-ups and for existing Zoho CRM orgs which are in the Professional edition exclusively for IN DC users. 2 March 2026: Available to users in all DCs except US and EU DC. 24

        • Comments aren't visible in shared spreadsheet

          I would like to send a spreadsheet to people who can use it to help solve a problem as a one off use unique to them. They will have to enter data in the sheet. I have comments attached to some of the cells to explain the purpose of the data being collected.

        • Custom button for list page

          Why is my 'List Page - Bulk Action Menu' button in the Packages module not autopopulating the List argument with selected record IDs?

        • Ask the Experts - Live Q&A webinar

          Hello Community, We’re excited to host our very first Ask the Experts session! Join us on 7 April 2026 from 11 a.m. to 12 p.m. (IST) for this live webinar Q&A session, where you will have an opportunity to connect directly with our product experts, gain

        • Designing Multi-Step Workflow System in Zoho Creator + Deluge (Startup Build – Exploring Advanced Architecture + Partnerships)

          Hi everyone, I’m currently building a Zoho-based system as part of an early-stage startup, and I’m looking to connect with others who have experience designing more advanced workflows in Creator + Deluge. This started as a standard application, but it’s

        • Bin Tracking with eBay integration

          When trying to setup bin tracking on items that are linked to eBay listings using the built-in Zoho eBay integration, I keep getting this error: "Storage Tracking cannot be enabled for items that are manually fulfiled or for serial/batch items tracked

        • Removing To or CC Addresses from Desk Ticket

          I was hoping i could find a way to remove unnecessary email addresses from tickets submitted via email. For example, a customer may email the support address AND others who are in the helpdesk notification group, in either the TO or CC address. This results

        • Update to CRM Custom Buttons: Collect Users' Location

          Hello everyone! Buttons in Zoho CRM allow you to extend the default CRM capabilities for your bespoke business needs. It provides the flexibility to connect to any third-party application to perform necessary actions. Wouldn't it be better, if those buttons

        • Is it possible to make tags "required"

          We would like to be able to make the tag field a requirement for agents before they can close a ticket. This would help with monthly reporting, where a lot of tickets end up with no tag, causing manual work to go back and add the correct tag for each

        • Prevent Automatic Milestone Inheritance for Newly Created Task Lists

          Hello Zoho Projects Team, We hope you are doing well. We would like to request an enhancement regarding how new task lists inherit Milestone association in Zoho Projects. Current Behavior: At the moment, when a new task list is created below an existing

        • I would like to know wich person viewed the file

          I have a franchise and my Operative Manual is in WorkdriveI, the user can´t download but despite I know How many views the file had, I would like to know wich person viewed the file Is it possible? thank you

        • Can I write a check in Zoho Books with no associated bill?

          This currently does not seem possible, and I have a client that desperately needs this function if I am able to convert them with Quickbooks. Thank you in advance for your reply. 

        • Cloning Module Customizations in Zoho FSM

          Hello Latha, I have two Zoho FSM accounts, each in a different data center. I would like to know if it is possible to clone the module customizations I have already completed in one account to my new account in the UAE from the backend. In other words,

        • Ordering of Teams

          Hi there, Currently, we cannot order Teams in Zoho Desk. Teams are ordered as they were created. It would be really helpful if we could customise the order of Teams. For example: We have the following Teams: Shipping Customer Service Sales Compliance

        • Estimate Module - Contact Field.

          Hello Latha and Team, Is it possible to make the Contact field optional in the Estimate module? Best regards, Chethiya.

        • Item with name in different languate

          Hello, is there a way to have an item with its name in different languages? For example: I sell an item in different markets and I'd like to have a Proposal and the Invoice with the Item Name in a specific language. Rino Bertolotto Zoho Specialist, STESA srl

        • How to keep track of bags, cans, drums of inventory?

          We buy and sell products that are packaged in bags 🛍️, cans🥫, drums🛢️, etc. with batch numbers. When we get a shipment of one of the products, how do we track we received (say) 10 cans each of 5L of a product and maybe we received 10 cans of another

        • This version of app doesn't support this notecard type Error

          So this problem is happening for any notes created within the last week, as well as any note recently edited on Android. I can open them on my phone fine, but they don't open on the website version. They DO work on the desktop app version. It's just web

        • PDF's Give Unsupported Type Error Message

          Many of the pdf files I add to Notebook work fine but in some cases when I try to open them on the Android App I get a message saying "Unsupported Type. Psst! You are using an older version of the app which does not support this note format. Please update

        • Cliq iOS can't see shared screen

          Hello, I had this morning a video call with a colleague. She is using Cliq Desktop MacOS and wanted to share her screen with me. I'm on iPad. I noticed, while she shared her screen, I could only see her video, but not the shared screen... Does Cliq iOS is able to display shared screen, or is it somewhere else to be found ? Regards

        • I am not able to check in and checkout in zoho people even location access allowed

          This issue i am facing in mackbook air m1, I allowed location in chrome browser and i also tried in safari but getting similar issue. Please have a look ASAP.

        • Is multiple invoice e-mailing possible?

          I wonder if following is possible: When you are in the invoice view, assume you have five invoices to five different customers that are pending (you have just created them, but not sent them away yet by email.) To the left of every invoice in the overview

        • Multiple packages in one shipment

          Guys we have been asking for this for years. we want to be able to ship multiple packages for one customer in the same shipment, so as to avoid entering shipping info repeatedly, and avoid customer getting multiple tracking emails. When does this arise?

        • I can't add a new customer in Zoho invoice? Anyone had this issue before?

          Ive been using Zoho invoice for over 6 years. Today I wanted to add a new customer to send an invoice to but it doesn't save when I try to access it from the pulldown menu when you go to send a new invoice.

        • set up an opportunity progress bar in canva

          Hi, set up an opportunity progress bar in canva I need help to set to reproduce the progress bar or equivalent of the opportunity steps in canva as in standard view (see capture ) Thank you in advance Amadou

        • Which Tool Is Best to Import MSG Files to HostGator?

          The best tool to import MSG files to HostGator is the MacGater Mac MSG Converter. This professional utility is specifically designed to simplify the migration of Outlook MSG files into web-based email services, including HostGator. It supports direct

        • Recurring event sync via Microsoft 365 Meetings

          I believe syncing Recurring through the Microsoft 365 Meetings integration is already in the works but I couldn't find a reference in the community to track the progress of this work.

        • What's New in Zoho Invoice | April - June 2025

          Hello everyone! We're excited to share the latest feature updates and enhancements we've made to Zoho Invoice from April to June 2025. In this, you will learn more about the following features: New Integrations via Zoho Marketplace Add Images to Email

        • Client Script | Update - Client Script Support For Custom Buttons

          Hello everyone! We are excited to announce one of the most requested features - Client Script support for Custom Buttons. This enhancement lets you run custom logic on button actions, giving you greater flexibility and control over your user interactions.

        • import customers

          Is there a way to bulk import customers? I'm moving from Acuity and would rather not have to enter everyone manually.

        • What's New in Zoho POS - February 2026

          Hello everyone, Welcome to Zoho POS’s monthly updates, where we share our latest feature updates, enhancements, events, and more. Let’s take a look at how February went. Purchase and sell items on different units We have introduced a unit conversion functionality

        • Batch Tracking custom function

          Hi fellow zoho users, We have our ecommerce site setup to shopify. I have some products I want to add batch tracking too, my only issue is that it breaks our shopify workflow (create sales order, invoice, payment, package) because it requires us to manually

        • Next Page