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:
- A resource YAML file defining the resource schema and its properties.
- An index.md providing an overview of the resource and helping LLMs and agents understand its overall context.
- 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:
- operation.md: a compressed Markdown representation of the respective operation from the OAS, optimized for efficient LLM/agent consumption.
- 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.
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:
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:
- Fetch all open deals this month.
- In the Leads module, I want to show the Passport Number field only if the NRI field's value is Yes.
- 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:
- 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.
- Select the right primitive - Determines whether the task is best handled by REST API, Deluge Function, ClientScript, Widget, COQL, Query, or Connection.
- Load the relevant references - Loads the appropriate references and using them as the source of truth for implementation details.
- Generate the solution - Produces the required code, query, API request, or configuration guidance based on the selected primitive and loaded references.
- 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,
- Review and test generated solutions before using them in production.
- 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.
- For organization-specific configurations, ensure to provide the relevant details in your request so the skill can tailor the solution to your setup.
- 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!
Happy exploring!
Zoho CRM API Team
Access your files securely from anywhere
Zoho FSM Video Tutorials
Centralize Knowledge. Transform Learning.
All-in-one knowledge management and training platform for your employees and customers.
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
Mable Mary M P
Jordan Talmor
Vivek Rai
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, VSCodeKaizen #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 theKaizen #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 how
New to Zoho TeamInbox?
Zoho TeamInbox 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
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
Zoho Community Digest - August 2026 | Part 4
Hi everyone, and welcome back! We're closing out August with a strong final week, from Incentives for Zoho CRM bringing commission management inside the platform to Sequences in Bigin automating customer follow-ups end to end. There's also an IP allowlistRelated Lists: Consolidate cross-module data
A new and efficient way to connect your project data across the boundaries of modules, entities, and applications. Introducing related lists to incorporate related records from any module, entity, or external source directly into the detail view of aZoho Workshops in Frankfurt a.M. | 07. & 08. Oktober 2026 | Nur noch 1 Monat
Liebe deutschsprachige Zoho Community, Nur noch einen Monat bis zu den Zoho Workshops in Frankfurt! Am 7. und 8. Oktober ist es soweit: Die Zoho Workshops kehren zurück und finden dieses Mal im Radisson Blu Hotel, Frankfurt am Main, statt. Wenn Sie IhreNeed 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 integerZoho Assist Remote Desktop on Android grey screen
With Zoho Assist Remote Desktop for Android when I connect to an unattended device I see only a Grey Screen. It worked fine before. This is a recently issue. I tried to clean data and cache, reinstall app, try and old version... but nothing. Always greyIntegration Multiple WooCommerce Stores
Currently, Zoho Marketing Automation supports connecting only one WooCommerce store per account. For businesses managing multiple brands or stores, this creates operational challenges, as they are forced to maintain separate accounts for each store. SuggestedIntroducing 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 dragFeature Request: Add Sort by Cell Color and Text Color functionality
Hello Zoho Sheet Development Team, I am writing to suggest a feature enhancement for Zoho Sheet. Currently, the platform supports "Filter by Color," which is incredibly useful. However, there is no native option to "Sort by Color" (by cell fill or textMCP for Zoho Sign is not working
I'm using the mcp builder at mcp.zoho.com and selected Zoho Sign. I have created it 4 different times but my other mcp servers are working. However, mcp for zoho sign WILL NOT WORK. It throws a 400 error. I've checked everything. I tried with both GrokAutomating CRM backup storage?
Hi there, We've recently set up automatic backups for our Zoho CRM account. We were hoping that the backup functionality would not require any manual work on our end, but it seems that we are always required to download the backups ourselves, store them,Zoho ERP | Product updates | July 2026
Hello users, We're back with another round of updates to help you streamline your operations. This month's release brings new features and enhancements designed to help you work more efficiently. Read on to discover everything that's new in Zoho ERP thisAndroid screen dissapeared
While running assist on an android tablet, screen poofs out of existence, have to restart sharing.Kaizen #229: Email-Deal Associations in Zoho CRM
Hi All, Welcome back to another week of Kaizen! Emails are a core channel for customer communication in any CRM system. In Zoho CRM, emails can be associated with records across multiple modules. In this post, we will focus on email associations withCross-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-applicationBank charges
Hello, team zoho I have a difficulty, in the form to register the payment of the customer has a field "bank charges" more when registering an expense or payment to the supplier that field does not appear. And I think that's a mistake because in my accountBank Feeds - Multiple Orgs / Multiple LLCs
Hi, We are migrating our books over from another service, and trying to connect our bank feeds. We have 3 separate LLCs, and 3 separate orgs in Zoho Books. We want to connect the bank feeds for each entity to each org. However, when we connect the 2ndWORK DRIVE CUSTOMIZATION
WORK DRIVE CUSTOMIZATION Create folder for every Case by “Contact Name “in Work Drive under Associate Deals Folder Directory: User Work Drive Accounts: Route Directory Associate Cases Case Name, Case Number Client Upload- Shared with contact (for collaboration)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. 24Vendor payment unexpectedly routed through Prepaid Expenses instead of Accounts Payable
Hello, We are investigating an unexpected accounting behavior in Zoho Books. We created vendor bills and vendor payments for two suppliers using what appears to be the same workflow, but the journal entries are different. Vendor 1 – UZ Store (works correctly)BANK CHARGES
When paying a supplier via credit card we are charged a fee. I process the payment through payments made and then enter the fees in bank charge. However i get this message : Bank charges are applied. Please select a bank account. And it will not letJOIN with Select and TOP not returning data to results
hi when I add TOP to yellow it does not return cl."Id", cl."Date",cl."Outcome", cl."Membership" from the join. Remove it and they appear. The TOP and the ON seem to work as in the number of rows returned. Doing the classic join log table and return only[Free webinar] Blueprint as a business process engine - Creator Tech Connect
Hello everyone, We are excited to invite you to another edition of the Creator Tech Connect webinar. About Creator Tech Connect The Creator Tech Connect series is a free monthly webinar comprised of pure technical sessions, where we dive deep into theAllow Email Attachments to Be Opened Directly in Zoho CRM
Hi all, It would be very helpful if attachments linked to an email in Zoho CRM could be clicked and opened directly from the email preview. Currently, the attachment names are displayed, but the experience of viewing them is unnecessarily limited. UsersDashboard Metric Drill-Down Shows Stale Data
Summary: When clicking between different metric components on a custom dashboard, the drill-down list shows data from the previously opened metric instead of the one just clicked. Steps to Reproduce: Create a custom dashboard with multiple pre-defined/templatizedZoho email suddenly stopped working - any ideas to fix this ?
Zoho email suddenly stopped working. although got this sent to me Reporting-MTA: dns; mx.zohomail.eu Arrival-Date: Wed, 26 Aug 2026 12:48:05 +0100 Original-Recipient: rfc822; Final-Recipient: rfc822; Status: 421 Action: delayed Last-Attempt-Date: 26 AugGCLID and Zoho Bookings
Is there anyway to embed a Zoho Bookings signup on a landing page and pass the GCLID information? More specifically, can this be done using auto-tagging and not manual tagging the GCLID? I know Zappier has an integration to do this but is there a betterCalendar Booking - Rescheduled and cancelled appointments not deleting in G Suite calendar
We started using the built in calendar booking feature and are really liking it! However, we are having one issue. If a client reschedules an appointment using the reschedule feature the original appointment doesn't get deleted out of our g suite calendarAutomate pushing Zoho CRM backups into Zoho WorkDrive
Through our Zoho One subscription we have both Zoho CRM and Zoho WorkDrive. We have regular backups setup in Zoho CRM. Once the backup is created, we are notified. Since we want to keep these backups for more than 7 days, we manually download them. TheyBackup to external location (Dropbox etc)
Dear Zoho Team, I've set the CRM Backup schedule to once a month, which when complete sends me an email. Of course I then need to manually login and download the file. Nice but VERY 20th century and relies on us humans not to fail. Can you please provideCloud backup for CRM
This is an idea / feature request for ability to periodically export CRM backup to an external cloud provider, similar to Zoho Vault: https://www.zoho.com/vault/data-backup.html Alternatively I would help being able to access manual data backup programaticallyIntroducing throw statements in Deluge
Hello everyone, We're introducing a powerful addition to Deluge that gives you more precise control over error handling in your scripts. Whether you're calling an external API, validating user input, or enforcing a business rule, there are moments whenWhatsApp Coexistence
Hello, please implement WhatsApp Coexistence, we need to track staff whatsapp chats on their PC and they need to be able to use WhatsApp on their mobile in around the office and warehouse, as we video call customers and send them product pictures. ThankZoho Creator to Zoho Writer for prefilled documents...
In response to the question about connecting Zoho Creator to Zoho Writer for prefilled documents, I wanted to share a working implementation that demonstrates how to use the record_id parameter with the Zoho Writer Merge API. This allows Writer to automaticallyUpload a video to embed into an article
How can we upload a video to embed into the article...? We can upload images but this only seems to support image files. And the video option seems to just support YouTube, Vimeo and DailyMotion which is no good, we need to create our own videos and uploadPAN - Aadhar Link Status
Can Zohobooks also get latest PAN-Aadhar Linking Status from Income Tax Portal ?LinkedIn RSC is now live in Zoho Recruit
LinkedIn Recruiter System Connect (RSC) is here. Your Zoho Recruit data (candidates, jobs, notes, stage updates, resume attachments, and more) now syncs with LinkedIn in real time. Note: LinkedIn RSC is included with your LinkedIn Recruiter CorporateZoho Writer for Android - Headings
Hello Zoho team, I have created structured doc with headings in writer web version on pc. Then I have opened it in my phone. Write is crashing while used function: menu "three dots", Document Navigation, Headings. Zoho Writer for Android 6.1.4 SamsungThe in between line spacing management
In the Microsoft Word, when we write something there is a tool from where we can manage the line spacing. Here in writer app in mobile it is by default 1.5. I request Zoho Team to give the option from where I can control Line Spacing, Remove space betweenZoho Books | Product updates | September 2026
Hello Partners, We've rolled out new updates to Zoho Books. From a brand-new Nigeria edition expanding our presence on the African continent to the new Super Admin privilege, here's everything that's new this month. Nigeria Edition Now Live [Nigeria Edition]Zoho Books | Product updates | August 2026
Hello users, July has been an exciting month for Zoho Books! This month, we're excited to introduce HTML PDF Templates, Placeholders as Pills, expanded approval workflows for Sales Returns and Journals, and significant compliance updates across the India,Next Page