Announcing the new SKILL.md for Zoho CRM and the updated OAS repository!

Announcing the new SKILL.md for Zoho CRM and the updated OAS repository!

We are introducing a new zoho-crm skill to make working with Zoho CRM Developer tools (like APIs, functions, widgets, client scripts, queries etc) easier and faster, with the help of AI in your preferred AI harness like Claude Code, Codex, Cursor, VSCode Copilot etc. We have also updated the OAS files in our public repository with latest changes. 

Updated OAS repository 

Along with the official release of the V8 APIs, we had released OAS files in our public OAS Git repository. 
Now, the existing OAS have been migrated from JSON to YAML. We have also updated these files to include the latest API changes and enhanced descriptions, providing better guidance for working with the APIs. 
We have moved to a new directory structure optimized for LLMs and AI agents to understand and navigate the API more effectively. 

Each OAS resource now has its own folder containing: 
  1. A resource YAML file defining the resource schema and its properties.
  2. An index.md providing an overview of the resource and helping LLMs and agents understand its overall context.
  3. An operations folder with separate subfolders for each operation, making individual API operations easier for LLMs and agents to identify and retrieve. Each operation folder contains:
    1. operation.md: a compressed Markdown representation of the respective operation from the OAS, optimized for efficient LLM/agent consumption.
    2. Examples: request and response examples specific to the operation.
This structure reduces the amount of information an LLM or agent needs to process when working with a specific API operation, while making operation discovery, contextual understanding, and access to relevant request/response examples much easier.
Quote
We will be releasing new OAS files weekly for the APIs, which are already released. We are also working to support more functionalities of Zoho CRM in the v8 APIs first via this public GIT repository, while working in parallel to host the same in our public help docs.

The new zoho-crm SKILL.md 

 The zoho-crm skill acts as an orchestration layer across the following CRM developer tools: 

REST APIs 

Selects the right CRM API v8 operation, resolves parameters and OAuth scopes from the OAS, and generates the request. With MCP, it calls the API tool directly; without MCP, it generates a complete cURL request. 

Deluge Functions 

Generates and validates server-side Deluge scripts for CRM automation and custom functions. 
Note: The skill currently supports Deluge functions only. It does not yet support generating functions in Java, Node.js, or Python. 

Client Script 

Creates browser-side scripts using ZDK for record pages, list views, buttons, validation, dialogs, and other UI behavior. 

Widgets 

Builds embedded components using HTML, CSS, JS, CRM JS SDK and ZRC, including CRM data access and external API integrations. 

COQL 

Constructs and validates COQL queries for filtered, cross-module, and aggregated CRM data retrieval, including the required API endpoint and scopes. 

Queries 

Helps configure saved Queries and determines when to use Module, COQL, Zoho CRM REST APIs, External Database, or Cloud Database sources, including variable-token usage and associations. 

Connections 

Guides OAuth-based integrations with external services and generates the correct connection usage for Widget, Deluge and Client Script. 

What should you do? 

Install the zoho-crm skill:

Quote
npx skills add zoho/crm-skills
 
Then, just describe your Zoho CRM use case in natural language, in your preferred AI harness like Claude Code/Codex/Cursor/Github Copilot/etc.. The skill will take it from there. 
 
For example, you can ask: 
  1. Fetch all open deals this month.
  2. In the Leads module, I want to show the Passport Number field only if the NRI field's value is Yes.
  3. If the lead's score reduces below 50, create a follow-up task to the record owner.

The zoho-crm skill in action


/zoho-crm is the command used to invoke the SKILL.md from Github Copilot in Visual Studio Code. You can also configure the skill to be invoked as a part of an Agentic flow for your use case. 
 
This demo showcases how the skill can help build a deluge function for a complex use case. When Zoho CRM MCP tools are connected, the skill can also invoke the relevant tools directly, reducing manual UI work and streamlining the development process. 

Behind the Scenes 

 The skill follows a five-step flow to turn a CRM development request into a validated solution: 
  1. Understand the goal - Identifies the Action, Entity, and Context from your request to understand what needs to happen, what CRM data is involved, and where it should run.
  2. Select the right primitive - Determines whether the task is best handled by REST API, Deluge Function, ClientScript, Widget, COQL, Query, or Connection.
  3. Load the relevant references - Loads the appropriate references and using them as the source of truth for implementation details.
  4. Generate the solution - Produces the required code, query, API request, or configuration guidance based on the selected primitive and loaded references.
  5. Validate the output - Checks the solution against CRM syntax, parameters, scopes, constraints, and known implementation gotchas before presenting it.

A Few Things to Keep in Mind 

The zoho-crm skill is designed to accelerate development, not replace developer review. As you work with it, 

  1. Review and test generated solutions before using them in production.
  2. The first generated output may occasionally need a few iterations to reach the desired implementation. Refine the request and provide feedback to help the skill improve the solution.
  3. For organization-specific configurations, ensure to provide the relevant details in your request so the skill can tailor the solution to your setup.
  4. For integrations with other Zoho products and third-party applications, provide required details about the product and its relevant help documentation wherever possible to help the skill provide more accurate responses. 
We can't wait for you to try this new zoho-crm skill and updated OAS files, put them to work with your CRM cases. We will continue refining the skill and keeping the OAS up-to-date alongside the new CRM capabilities and improvements. 
 
Have questions or want to share feedback? 
Write to us at support@zohocrm.com. 
As always, your feedback is invaluable to us! 

Happy exploring! 
Zoho CRM API Team



    Access your files securely from anywhere

        Zoho FSM Video Tutorials

          Workforce
          Mobile App
          Job Scenarios
          Scheduled Maintenance
          FSM × Desk
          FSM × Books & Invoice
          FSM × WhatsApp

          MCP Tool Guide MCP Changelog
              What's new
              Blogs
              Community
              Zia
              API resources
              Pricing
              Integrations
              Town Hall
              Custom Apps


              All-in-one knowledge management and training platform for your employees and customers.






                                    Zoho Developer Community



                                        Bootcamp
                                        Community
                                        Pricing
                                        Webinars
                                        What's New
                                        Integrations
                                        Contact Support
                                        Contact Sales
                                          Zoho Survey Resources
                                            Features
                                            Survey Templates
                                            Integrations
                                            Community
                                            iOS Mobile Surveys
                                            Pricing
                                            Android Mobile Surveys
                                            Insurvey Blogs
                                            Insight Blogs
                                            Tips & Tricks





                                                        Latest Feature Updates

                                                          • Desk Community Learning Series


                                                          • Digest


                                                          • Functions


                                                          • Meetups


                                                          • Kbase


                                                          • Resources


                                                          • Glossary


                                                          • Desk Marketplace


                                                          • MVP Corner


                                                          • Word of the Day


                                                          • Ask the Experts




                                                              Zoho SalesIQ Resources

                                                                    • Sticky Posts

                                                                    • Announcing the new SKILL.md for Zoho CRM and the updated OAS repository!

                                                                      We are introducing a new zoho-crm skill to make working with Zoho CRM Developer tools (like APIs, functions, widgets, client scripts, queries etc) easier and faster, with the help of AI in your preferred AI harness like Claude Code, Codex, Cursor, VSCode

                                                                    • Kaizen #256 - Build an Arrival Readiness Web Tab in Zoho CRM

                                                                      Hi everyone! Welcome back to the Kaizen series! In the post, we discuss a use case in hospitality industry: how an Arrival Readiness web tab widget can be used to let reception staff identify and resolve issues before arrival of guests. Use case In the

                                                                    • 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


                                                                    Manage your brands on social media
                                                                    Access Zoho Social

                                                                      Zoho Pagesense Resources


                                                                          Zoho TeamInbox Resources

                                                                            Zoho DataPrep Resources


                                                                              Zoho CRM Plus Resources

                                                                                Zoho Books Resources


                                                                                  Zoho Billing Resources

                                                                                    Zoho Projects Resources


                                                                                      Zoho Sprints Resources


                                                                                        Qntrl Resources


                                                                                          Zoho Creator Resources



                                                                                              Zoho CRM Resources

                                                                                              • CRM Community Learning Series

                                                                                                CRM Community Learning Series


                                                                                              • Kaizen

                                                                                                Kaizen

                                                                                              • Functions

                                                                                                Functions

                                                                                              • Meetups

                                                                                                Meetups

                                                                                              • Kbase

                                                                                                Kbase

                                                                                              • Resources

                                                                                                Resources

                                                                                              • Digest

                                                                                                Digest

                                                                                              • CRM Marketplace

                                                                                                CRM Marketplace

                                                                                              • MVP Corner

                                                                                                MVP Corner









                                                                                                  Design. Discuss. Deliver.

                                                                                                  Create visually engaging stories with Zoho Show.

                                                                                                  Get Started Now


                                                                                                    Zoho Show Resources

                                                                                                      Zoho Writer

                                                                                                      Get Started. Write Away!

                                                                                                      Writer is a powerful online word processor, designed for collaborative work.

                                                                                                        Zoho CRM コンテンツ




                                                                                                          Nederlandse Hulpbronnen


                                                                                                              ご検討中の方





                                                                                                                        • Recent Topics

                                                                                                                        • Admin Logging in as another User

                                                                                                                          How can a Super Admin login as another user. For example, I have a sales rep that is having issues with their Accounts and I want to view their Zoho Account with out having to do a GTM and sharing screens. Latest Update (27th April 2026): With the early

                                                                                                                        • ChatGPT Plugin / MCP Server auth error

                                                                                                                          Hi all I'm trying to connect the ChatGPT plugin for Zoho CRM but after username stage of the auth process, I get this error. {"error_description":"Invalid request url, Request is not as per defined in oauth metadata.","error":"mcp_error"} I've tried in

                                                                                                                        • Open Records in a New Browser Tab

                                                                                                                          Hi FSM Team, Just a suggestion: It would be helpful to have a right-click → Open in New Tab option in FSM, similar to CRM. This should ideally work for any clickable record or module, allowing users to open multiple records in separate tabs without losing

                                                                                                                        • Dashboards for Customers

                                                                                                                          Is it possible to build dashboards for each customers in the community for their tickets?

                                                                                                                        • Project Management Platforms for AI Agents: What Matters Most?

                                                                                                                          Zoho Projects is already going beyond basic AI assistance with MCP, AI Bridge, and integrations that let AI models access project data and perform actions. That raises an interesting question: what should a project management platform for AI agents actually

                                                                                                                        • Cannot add note to record on mobile

                                                                                                                          In the latest version of the mobile app - if a record already has notes associated with it - you can add a note via the mobile app - if a record does not have previous notes there is no way to add a new one - it allows me only to send email

                                                                                                                        • Custom color coding for your entities

                                                                                                                          Our brains are fine tuned to recognize colors before any text or shapes, making color coding a powerful tool to organize data and find items quickly. Color coding of our day-to-day work help with quickly processing the information, reducing cognitive

                                                                                                                        • The Social Wall: August 2026

                                                                                                                          Hello everyone. Welcome to the August 2026 edition of The Social Wall. This month, we're bringing you updates that make it easier to reach your audience, manage more channels, and streamline your publishing workflow. Here’s what’s new. WhatsApp bulk messaging

                                                                                                                        • Check out in Meetings

                                                                                                                          Why there is no check out in Meetings of Zoho CRM, very difficult to track

                                                                                                                        • How do I get to "Admin Panel"

                                                                                                                          I just started a Cliq account. I am the sole administrator. As I read the documentation, I keep seeing reference to an "Admin Panel". I see no way to access this from my Cliq account. How do I access this panel?

                                                                                                                        • 【初開催！ オンライン】Zoho Campaigns メール配信の基礎・活用勉強会を開催します！ 10/15 参加無料

                                                                                                                          ユーザーの皆さま、こんにちは。 Zoho コミュニティグループの中野です。 Zoho ユーザーコミュニティ初となる、メールマーケティングをテーマにしたオンライン勉強会を開催します！ ▶︎イベント詳細・参加登録はこちら 今回取り上げるサービスは「Zoho Campaigns」です。 「Zoho CRMとZoho Campaignsのどちらからメールを配信すればよいか分からない」 「一斉配信はできるようになったけれど、現在のリスト管理や設定が正しいか不安」 「メールを送るだけで終わり、配信後の改善につなげられていない」

                                                                                                                        • Lookups and Custom Modules

                                                                                                                          I created a Custom Module that I'm calling "Item Purchasing Group". This module will store information for groups of Items that must be purchased together (including minimum overall quantities and/or values, etc.). This will have a one-to-many relationship

                                                                                                                        • Marketing Tip #46: Run flash sales the right way

                                                                                                                          A flash sale can do a lot for your store. It can clear slow-moving inventory, spike revenue on a slow day, or reward your most loyal customers. But if done carelessly, flash sales can backfire. Customers start expecting discounts, stop buying at full

                                                                                                                        • Introducing Smart Fields in Zoho Forms

                                                                                                                          Hello form builders! We are excited to introduce Smart Fields in Zoho Forms - a faster way to add calculations to your forms without writing formulas. Instead of creating multiple fields and configuring complex calculations yourself, you can now drag

                                                                                                                        • Checkbox not displaying correctly in subform

                                                                                                                          Greetings: I have shared my app (wv) with support.  I am having problems with a checkbox field not displaying correctly in a subform.  The main form is called volunteers and the subform is called volunteers_subform.  The field in question is called roles. When you access the subform by itself the checkbox lookup displays as checkboxes.  But when you view it in the main volunteers form, it displays as a multi-select dropdown instead.   I have attached jpegs showing the difference.   Any thoughts?

                                                                                                                        • Unbundle feature for composite items

                                                                                                                          We receive composite items from our vendors and sell them either individually or create other composite items out of them. So, there is a lot of bundling and unbundling involved with our composite items. Previously, this feature was supported in form

                                                                                                                        • The reason I switched away from Zoho Notebook

                                                                                                                          My main reason for switching to Zoho was driven by three core principles: moving away from US-based products, keeping my data within India as much as possible, and supporting Indian companies. With that intent, I’ve been actively de-Googling my digital

                                                                                                                        • Valid characters for use in email addresses using Zoho's apps/APIs

                                                                                                                          We have found an issue with the + sign character in zoho subs - we are allowed to create a customer with an email address that has a plus sign but the API doesn't allow the + so the billing portal is not created. We are going to prevent users from using

                                                                                                                        • Expand Zoho Analytics Spatial Capabitlities

                                                                                                                          Dear Analytics team Thanks for the great product - I'm a big fan on Analytics and the monthly release highlights is one of my favourite emails to receive. I'd like to request expansion and improvement of Zoho Analytics spatial data capabilities, namely:

                                                                                                                        • Automate customer follow-ups with Sequences in Bigin

                                                                                                                          Greetings, We hope you're all doing well! We're happy to announce a new feature that we've added to Bigin. Following up with every lead at the right time can be challenging, especially when your team is managing multiple conversations across emails, calls,

                                                                                                                        • Displaying only unread tickets in ticket view

                                                                                                                          Hello, I was wondering if someone might be able to help me with this one. We use filters to display our ticket list, typically using a saved filter which displays the tickets which are overdue or due today. What I'd really like is another filter that

                                                                                                                        • Adding Custom Status Options in Work Order Action Menu

                                                                                                                          Hello FSM Team, We would like to inquire if it is possible to add more custom options in the Work Order action/status dropdown (e.g., Cancel, Terminate, Non-Billable, Void, etc.). Currently, the available options are limited, and we are unable to customize

                                                                                                                        • Can we have an automated TDS Receivable Recon with Form 26AS of Income Tax Portal ?

                                                                                                                          Can we have an automated TDS Receivable Recon with Form 26AS of Income Tax Portal ?

                                                                                                                        • Tag Limi?

                                                                                                                          is there any way to create more than 20 tags? 

                                                                                                                        • prefill_data for Creator + Merge & Sign

                                                                                                                          Hello, Is there an option to use prefill_data for signer fields from creator? I see the option for CRM but it will not work with creator? I have tried passing the value in the signer data, and that also does not work. Alternatively, is there a way to

                                                                                                                        • Delug script

                                                                                                                          I have been looking at auto-update a amount (home currency) field from another module. Zoho native multicurrency was used in the other module (we have 4 here). Custom script was input with no error, but the field was not updated on trigger. Script as

                                                                                                                        • Can I Build a Gaming Website Using Zoho? Need a Quick Roadmap

                                                                                                                          Hi Dear Members, I want to create a gaming website using Zoho. Is it possible? My goal is to build a sleek, unique, easy-to-navigate, and fast-loading website for a gaming project. I want the site to look professional, user-friendly, and optimized for

                                                                                                                        • Remove Due Date from Statements

                                                                                                                          Is it possible to remove the Due Date on the Invoice transation line on statements? I have figured work arounds to get the Invoice detail on the Statement but cannot work out haw to simplify the stament by removing the "- due on xx/xx/2026" - it really

                                                                                                                        • What Should an Agent-Native Project Workspace Look Like

                                                                                                                          AI is moving beyond assistants that simply answer questions. With tools like MCP, agents can now interact directly with project data and perform actions. That makes me wonder: what should an agent-native project workspace actually look like? For me, it

                                                                                                                        • unable to join meeting due to speaker issue

                                                                                                                          unable to join meeting due to speaker issue

                                                                                                                        • How to add formatting in zoho.cliq.postToUser(...) message?

                                                                                                                          In a CRM Deluge function, I'm trying to use the message formatting guidelines given here: https://www.zoho.com/deluge/help/cliq/posting-to-zoho-cliq.html#message-formats My message is: message: #Title text. The result in Cliq is: #Title text. (no large

                                                                                                                        • Marketing Tip #50: Sell digital products and use them to grow your store

                                                                                                                          Physical products need packaging, shipping, and stock management. Digital products need none of that. Once created, they can be sold an unlimited number of times, delivered instantly, and never go out of stock. What counts as a digital product? A digital

                                                                                                                        • Turn off Mobile Optimize

                                                                                                                          Hello is it possible to stop the automatic mobile optimization of my site as it looks much better on a mobile in full site format rather than mobile format. Thanks

                                                                                                                        • How to select from pricebook when creating a salesorder or quote

                                                                                                                          I am creating a sales order and when selecting the Products I do not see any where to select from pricebooks. How do i associate this to my orders?

                                                                                                                        • API - Available Stock Definitions

                                                                                                                          Okay, Zoho team... your copywriters fell down on the job for this one :) I think these warrant a bit more explanation as to what they include and what they don't.

                                                                                                                        • Cross-application Deluge calls fail when application link name starts with a number

                                                                                                                          I encountered an issue when calling a custom function in another Zoho Creator application within the same account. The target application’s URL/application link name began with a number, similar to: 27_example_application The following cross-application

                                                                                                                        • Transformez vos webinaires en opérations automatisées

                                                                                                                          Organiser un webinaire, c’est bien plus que passer en direct. Il faut gérer les inscriptions, suivre les participants, envoyer les enregistrements, mettre à jour le CRM… et s’assurer que chaque étape se déroule au bon moment. L’automatisation des workflows

                                                                                                                        • Marketing Tip #1: Optimize item titles for SEO

                                                                                                                          Your item title is the first thing both Google and shoppers notice. Instead of a generic “Leather Bag,” go for something detailed like “Handcrafted Leather Laptop Bag – Durable & Stylish.” This helps your items rank better in search results and instantly

                                                                                                                        • How can I filter inactive/disable agent tickets?

                                                                                                                          Hello, We have an user-agent that left the company and we inactive/disabled his agent. So, now I can no longer filter or search tickets that he is the current owner, or even create a rule to reassign tickets to another person when the ticket is reopen.

                                                                                                                        • How do i move multiple tickets to a different department?

                                                                                                                          Hello, i have several tickets that have been assigned to the wrong department.  I am talking about hundreds of automatically generated ones that come from a separate system. How can i select them all at once to move them to another department in one go? I can select them in "unsassigned open tickets view" but i can't find a "move to another department" option. I also can't seem to assign multiple tickets to the same agent in that same view. Could somebody advice?

                                                                                                                        • Next Page