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



    • 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 #261 : Using Zoho CRM Skill to generate complex COQL queries

      Hello everyone, In the previous Kaizen posts, we introduced the zoho-crm SKILL.md and discussed how it can help you when you are working with Zoho CRM APIs and Client Script. In this Kaizen, we will focus on using the Zoho CRM `SKILL.md` with GitHub Copilot
    • 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
    • Recent Topics

    • Feature Request - Ability to Customise Contact Info Card on Ticket Details View

      Hi Desk Team, I've added a "Contact Priority" and "Account Prioirty" field and it would be very useful to agents if they could see that information in the Contact Info card on the Ticket Details view. It would be great if we could choose some fields to
    • What is a realistic turnaround time for account review for ZeptoMail?

      On signing up it said 2-3 business days. I am on business-day 6 and have had zero contact of any kind. No follow-up questions, no approval or decline. Attempts to "leave a message" or use the "Contact Us" form have just vanished without a trace. It still
    • Customer portal: recommended way to scope lookup fields to the logged-in client?

      Hi all, I'm building a customer portal on Creator for our clients (we're a esting lab, so each client has their own sites, contacts and jobs). Planning stage, so I'd rather get the approach right before I build it. The portal forms need several lookup
    • Zia for Mail: AI-powered assistance for Email, Calendar, and ToDo in Zoho Mail

      Zia for Mail brings AI assistance into Zoho Mail for everyday email, calendar, and task activities. Administrators can integrate third-party AI providers, such as ChatGPT or Gemini, and decide which features are available to users. What is Zia for Mail
    • "Else / If" Statement in Zoho CRM Inventory Template

      Hello, I would like to use the below "Else If" in my Inventory Templates, but it's not working correctly. Essentially, if the field "Quote Payment Terms" is filled in, display that. If "Quote Payment Terms" is blank, display "Account Payment Terms" instead.
    • Office Integrator

      Our users are complaining the slowness and speed when working in Zoho Office. Explicitly when working in a sheet. Here are observed issues *Copy and pasting values from one cell into another takes 10-20 seconds to show it has done it. *Modifying a value
    • [ZohoDesk] Improve Status View with a new editeble kanban view

      A kanban view with more information about the ticket and the contact who created the ticket would be valueble. I would like to edit the fields with the ones i like to see at one glance. Like in CRM where you can edit the canvas view, i would like to edit
    • Subform UI Unresponsive

      Has subform with a couple of hundreds of rows but suddenly the you can't add any row nor edit any fields. The subform has 10 columns Any thoughts on this Zoho team?
    • Kaizen #267: Four Developer Tools, One Prompt: Cracking Custom Cases with the Zoho CRM Skill

      Hello everyone! Welcome back to another Kaizen post. In this Kaizen, we’ll see how the Zoho CRM Skill solves a custom use case that requires multiple Zoho CRM developer tools. You describe the requirement in plain language, and the skill identifies the
    • 【開催報告】 福岡 ユーザー交流会 NEXUS 2026/10/30 | CRM×AIの実践事例とZia Agents活用を紹介

      Zoho ユーザーの皆さん、こんにちは。 コミュニティグループの中野です。 10月30日(金)、福岡にてZoho ユーザー交流会 NEXUSを開催しました。 今回は、Zoho CRM × AIをテーマに、ユーザーさんによる実践事例、 Zia Agentsのデモ、参加者同士のグループワークなどを実施しました。 ご参加いただいた皆さん、ありがとうございました! 本投稿では、当日の様子を一部ご紹介します。 ユーザー活用事例 :Zoho CRM × AIを、実際の営業業務でどう使う? 登壇者:株式会社etika
    • KB Articles from Zoho Learn - Import as .md

      I love the concept of being able to use articles from Zoho Learn as knowledge base articles for Zia Agents. This will absolutely help with proper documentation and organization of company processes and SOPs. This was a great concept. However, even when
    • Service Account Admin for API Calls and System Actions

      Hello, I would like to request the addition of a Service Account Admin option in Zoho product. This feature would allow API calls and system actions to be performed on behalf of the system, rather than an active user. Current Issue: At present, API calls
    • Trigger workflows from SLA escalations in Zoho Desk?

      Hey everyone, I’m currently working with SLA escalation rules in Zoho Desk and ran into a limitation that I’m hoping someone here has solved more elegantly. As far as I can tell, SLA escalations only support fairly limited actions (like changing the ticket
    • Trident Missing

      No way you guys get so close to having trident complete for over a year then just kill it off. Wow just wow
    • Zoho One - Can I add a Custom View to All Departments

      We have been using Desk for several years but are just making the leapt to using multiple departments. I have a custom view that is our default view. I'd like to apply that to All Departments. When I try to add a view when viewing All Departments I get
    • A way to create kits (groups of items) that do not require bundling and are added to an order as the individual items

      We are evaluating moving off of Sage BusinessWorks (which handles accounting, order entry, inventory control, accounts receivable, etc) to Zoho Books/Inventory. One of the things we heavily use is a feature called Kits, which allows creating a group of
    • Issue While Rescheduling Interviews in Zoho Recruit

      Dear Zoho Support Team, We are facing an issue with the Interview Rescheduling functionality in Zoho Recruit integrated with Microsoft Teams. Problem Description When an interview is rescheduled through Zoho Recruit: The new interview is created successfully
    • Global Constants / Variables

      It would be great if there were a Global Constant feature. The idea here is for managing constants that are used in multiple Flows and Subflows, but might change over time. The idea is that the change could be made in one place and cascade to all future
    • Zoho Campaigns 3.0 is here

      Zoho CampaignsAnnouncements We're excited to introduce the all-new Zoho Campaigns, where we have introduced our biggest update yet. Marketing has evolved far beyond email. Today's campaigns span email, SMS, and WhatsApp, customers expect personalized
    • Tip #95 – Collect support requests right from your website with Web Forms – 'Insider Insights'

      Hello Zoho Assist Community! When a customer needs help, the first step often decides how smooth the rest goes. They email a vague description, a technician asks follow-up questions, and the real details only surface after several rounds of back and forth.
    • Unable to integrate Whatsapp Messaging into Zoho CRM - Business Messaging

      Hello, I want to set up Business Messaging in our Zoho CRM and am struggling to set it up. I have logged into the account and our facebook business page, our business shows in the dropdown for WhatsApp Business Account but does not for WhatsApp Business
    • E-Invoicing Automation

      Do you have an API endpoint for pushing the invoice through the e-tims for Kenya
    • Phone system to integrate with Zoho CRM

      I am looking for phone software that would allow my agency to do the following within Zoho CRM: Make calls from zoho Track calls and notes Leave pre-recorded messages after reaching voicemail of lead Only 2 members, so need company who will allow just
    • Automation Series: Automate Project File Uploads from Zoho WorkDrive

      Project documents are often prepared before development begins. When files such as product requirements, design files, guidelines, or plans are stored in a shared folder in Zoho WorkDrive, teams can automate copying them to the corresponding project team
    • Is it possible to report on Task Duration in minutes/hours rather than by start and due date?

      I'm currently evaluating the free version of CRM and I like lots of things about it, it will definitely help my business with sales automation and I will upgrade to a paid version once the evaluation is finished. However, I also want to use CRM for existing clients (accounts) where I can track how much time is being spent on tasks for these clients.  I can see clearly that both calls and events for each account have time tracking in minutes / hours but tasks do not have this. Is it possible in one
    • Why is it so hard to get a fiscal YTD P&L report in Zoho Books?

      Yes I know that it could be done in Zoho Analytics, but I would have expected this default report view to be easily accessible in the list of Books accounting reports. Just like any other basic accounting system, I'm looking for monthly columns of the
    • ¡Nuevo Meetup en Barcelona! - Automatiza procesos con los agentes de Zia en Zoho

      ¡Hola a todos! Estamos encantados de anunciaros que el próximo 3 de diciembre estaremos en Barcelona con un nuevo Meetup de Español Zoho Community. Estos encuentros son una oportunidad fantástica para conectar con otros usuarios de Zoho, ampliar conocimientos
    • Stock count by bin location

      Is there a configuration to make a stock count by bin or area and not by product. these is useful to manage count by area Regards
    • Bank Feeds - Again

      Bank feeds broken again for me. I don't see other recent posts on this, so maybe it's just us? Tried: refresh update cred/ deact./react. feeds chat support Nothing. On day 2 without zoho as a result, which is crippling for us. We've used zoho for a year
    • Introducing Auto Check-out for Attendance

      We are pleased to announce the release of the Auto Check-out feature in Zoho People. Auto Check-out is now available as a built-in setting under Shifts to automatically check out employees who have not recorded their check-out for the day. Administrators
    • Issue with SalesIQ Chats Automatically Closing Due to the 24-Hour Idle Timeout?

      Hello, I am experiencing a significant issue with SalesIQ automatically closing chats due to the Idle Timeout setting. I use SalesIQ through the integration between SalesIQ and Line App. To be honest, this issue has become extremely frustrating. Problems
    • 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 from the URL https://mcp.zoho.eu/mcp-client/ {"error_description":"Invalid request url, Request is not as per defined in oauth
    • Zoho Amount Cell Greyed Out

      I noticed a few days ago that the 'amount' cell on my Zoho App software in my windows PC is greyed out and I can't click on it to add an amount figure when recording invoice or expenses. Wheareas on mobile I can do it easily
    • 申請メール、まだ一件ずつ確認していませんか?― Zoho Formsで申請業務を効率化

      ユーザーの皆さま、こんにちは。ゾーホージャパンの友田です。 「備品を購入したいので申請します」 「イベントに参加したいです」 「経費の申請をお願いします」 このような社内申請を、メールやチャットで受け付けていませんか? メールでも申請はできますが、 「必要な情報が書かれていない」 「申請内容をあとから一覧にまとめている」 「誰がどこまで確認したのか分からない」 といった手間が発生することも。 そんな申請業務にも、Zoho Formsを活用できます。 必要な情報を、フォームでまとめて入力 例えば、備品購入の申請なら、
    • URGENT: Zoho Wiki searches return garbled nonsense

      For at least the past few days, the Search function in Zoho Wiki has been returning only strings of random characters. Example search result: The page name is readable, but the context body text is gibberish. So something is obviously broken with either
    • Is it really true that I can't set the default 'deposit to' account in 2025?

      I've been using Books for 7 years and the default account has never been a problem. I usually manually reconcile invoices and have never had a thought about which account. It has always been my account. However, I recently noticed that for the past 4
    • Zoho CRM gets a new email compose and lot more

      Dear Customers,  [UPDATE October 21, 2021: We have started opening these features to some of the customers already. And, it will be available to all the customers before November 2nd Week, 2021. Sorry for the delay caused]  [UPDATE February 21, 2022:
    • #19 What about the money I spend on the job?

      Meera buys props for a shoot, keeps the receipt in her bag, and expects to photograph it on the way back and never think about it again. The props get billed to the client at cost. The usual way to do this Covered in our published Expenses FAQ. The short
    • BNZ Bank Feeds No Longer Available

      The BNZ (New Zealand) bank feeds are still failing and it's been months since they last worked! Uploading bank statements (CSV's) mean waiting to the end of the month when they become available. It is unacceptable to keep my clients waiting for payment
    • How To Implement an Auto-Check-out Feature for Attendance?

      If an employee forgets to check out, the system should automatically check out the employee at 6:30 PM
    • Next Page