Migration of Zoho CRM APIs and Functions to v2.0 - Updated!

Migration of Zoho CRM APIs and Functions to v2.0 - Updated!

Hello everyone,

A year back, we released the CRM API Version 2.0 that provides a lot more than what we have in API v1.0. Along with that, we also announced the deprecation of API v1.0 and its sunset on December 31, 2019. Here is the link to the previous announcement.

We would like to remind you to migrate to the latest version of CRM APIs as soon as possible, as the older version will not be available next year onwards. If your code still uses the version 1.0 of the APIs they will stop working from January 1, 2020, and there would be some possible data loss.

In Zoho CRM, go to Setup > Developer Space > APIs. If the API dashboard displays a banner that your application uses the v1.0 APIs, the API calls could be made from one or all of the below locations.
  1. Deluge functions
  2. Direct API calls
  3. Third-party integration
1. Deluge Functions
Deluge functions (either in Zoho CRM or other Zoho services) use the v1.0 APIs in invoke methods and/or integration tasks.

a. Invoke method
Change all instances of v1 URLs used in getUrl, postUrl, or invokeUrl Deluge tasks to their equivalent URLs in v2.

b. Integration tasks
In Zoho CRM, go to Setup > Developer Space > Functions and change all the v1.0 integration tasks used in functions that are marked as "Deprecated" to v2.0.
Ensure to change the v1.0 integration tasks used in other Zoho services as well.

Refer to our Functions Migration Guide to know more on how to migrate integration tasks and invoke URLs.

To stop further usage of the deprecated version, from November 1, 2019, we will disallow the creation of new functions in Deluge using v1 integration tasks and native v1 URL invocation.
Also, you will not be able to update a function created after this date to use v1 integration tasks or invoke URLs.


2. Direct API Calls
If there are application-specific scripts written in different programming languages for your organization, and they make calls to Zoho CRM using the v1.0 APIs, you must change such instances to v2.0 as well.

Use the below checklist for easy migration of the APIs.
  1. Check whether you need to migrate your user's access tokens or re-authenticate with a new permission.
  2. Familiarize yourself with the new v2 syntax. API v2.0 accepts only JSON input.
  3. Familiarize yourself with the changes in field attributes and field formats. The same is mentioned in the help document: Differences - v1 and v2.
  4. Take a look at the API methods available in v1 and how different they are in v2 here.
  5. Update the error handling in your app to utilize v2 errors with proper status codes.
Refer to our API Migration Guide for more details.

3. Third-party integration
Your CRM account may be integrated with any third-party application like Mailchimp, Zendesk etc. that still uses the v1.0 APIs. In this case, you can only urge the third-party vendors to migrate to version 2.0 at the earliest. To facilitate faster migration, we have already mailed some of the vendors requesting them to move to v2.0.

Usage of the domain "crm.zoho.com" in v2 APIs


We highly recommend that you use https://www.zohoapis.com as the domain instead of crm.zoho.com, to reap the full benefits of the v2 APIs. 
Ensure that you specify your domain based on the data center your account is in. For example, if your account is in the EU data center, then your API URL must be https://www.zohoapis.eu.

Refer to Multi DC Support for more details about the various DCs and their respective API URLs.


To keep everyone informed of these changes, we have
  • Sent reminder emails to the primary users of all organizations that still use the v1.0 APIs in their code.
  • Displayed a banner on the Setup page alerting the users of the usage of v1.0 APIs.
  • Displayed a banner on the Functions page with an attached PDF containing the list of functions in your organization that you need to migrate to v2.0. 
Update:
When are the banners displayed?
  • You have made v1.0 API calls in the last 24 hours.
  • On the Functions page, when your functions still use v1.0 integration tasks or invoke URLs. Please note that these stats are refreshed once every 24 hours. So, even if you update/delete a function that uses the v1.0 code, it will still appear in the PDF until the stats are refreshed.

We strongly recommend that you complete the migration soon to avoid any data loss. If you have further questions, please contact us at support@zohocrm.com.


Regards,
Shylaja
Zoho CRM







    Access your files securely from anywhere

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







                              Zoho Developer Community




                                                    • Desk Community Learning Series


                                                    • Digest


                                                    • Functions


                                                    • Meetups


                                                    • Kbase


                                                    • Resources


                                                    • Glossary


                                                    • Desk Marketplace


                                                    • MVP Corner


                                                    • Word of the Day


                                                    • Ask the Experts



                                                              • 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


                                                              Manage your brands on social media



                                                                    Zoho TeamInbox Resources



                                                                        Zoho CRM Plus Resources

                                                                          Zoho Books Resources


                                                                            Zoho Subscriptions Resources

                                                                              Zoho Projects Resources


                                                                                Zoho Sprints Resources


                                                                                  Qntrl Resources


                                                                                    Zoho Creator Resources



                                                                                        Zoho CRM Resources

                                                                                        • 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

                                                                                                                • Kaizen #121 : Customize List Views using Client Script

                                                                                                                  Hello everyone! Welcome back to another interesting Kaizen post. In this post, we can discuss how to customize List Views using Client Script. This post will answer the questions Ability to remove public views by the super admin in the Zoho CRM and Is
                                                                                                                • Setting default From address when replying to request

                                                                                                                  At the moment, if I want to reply to a request, the From field has three options, company@zohosupport.com, support@company.zohosupport.com, and support@company.com.  The first two are really internal address that should never be seen by the customer and
                                                                                                                • Tip #45 - Explore Your Support Reach with Zoho Assist’s Geo Insights - 'Insider Insights'

                                                                                                                  Understanding where your remote support sessions are happening can help you make smarter decisions, allocate resources effectively, and improve overall customer satisfaction. In this week's Zoho Assist's community post we will be exploring Geo Insights
                                                                                                                • Formatting of text pasted into Zoho documents

                                                                                                                  Howdy, I'm a newbie and finding Zoho an improvement to MS Word. Consider yourself hugged. High on my wish list would be plain text cut-and-paste. When pasting text from the web to Zoho, presently Zoho imports the formatting along with the text. This means that every cut-and-paste operation brings in text in a different font, size, or style. Can we have at least the option of importing plain text without formatting (or better yet, is this option already out there?) ... Thanks Helen
                                                                                                                • Add additional features to Zoho Tables

                                                                                                                  Zoho Tables is a really great tool, why not add features like diagramming capability into the tool from applications like Draw.io which I believe is open source, you should be able to do wireframes, process flow diagrams, network design, etc. Please note
                                                                                                                • The Social Wall: August 2025

                                                                                                                  Hello everyone, As summer ends, Zoho Social is gearing up for some exciting, bigger updates lined up for the months ahead. While those are in the works, we rolled out a few handy feature updates in August to keep your social media management running smoothly.
                                                                                                                • The Social Wall: July 2025

                                                                                                                  Hello everyone! July has brought some exciting new updates to Zoho Social. From powerful enhancements in the Social Toolkit to new capabilities in the mobile app, we’ve packed this month with features designed to help you level up your social media presence.
                                                                                                                • Use Zoho Creator as a source for merge templates in Zoho Writer

                                                                                                                  Hello all! We're excited to share that we've enhanced Zoho Creator's integration with Zoho Writer to make this combination even more powerful. You can now use Zoho Creator as a data source for mail merge templates in Zoho Writer. Making more data from
                                                                                                                • Tagged problem !!!

                                                                                                                  Damn it, we're one of dozens of construction companies in Africa, but we can't link purchasing invoices to projects. Why isn't this feature available?
                                                                                                                • Syntax for URLs in HTML Snippets

                                                                                                                  What are some best practices for inserting a URL in an HTML snippet? I've looked at Zoho Help articles on navigation-based and functional-based URLs, but I'm still unclear on how to incorporate them in an HTML snippet. For example, 1. How do I link to
                                                                                                                • The Social Wall: June 2025

                                                                                                                  Hello everyone, We’re back with June Zoho Social highlights. This month brought some exciting feature updates—especially within the Social Toolkit—to enhance your social media presence. We engaged with several MSME companies through community meet-ups
                                                                                                                • Tip 7: How to fetch data from another application?

                                                                                                                  Hi everyone, Following our Zoho Creator - Tips and Tricks series every fortnight, we are back today with a tip based on one of the most popular questions asked in our forum. This tip would help you fetch data from another application(App B) and use it
                                                                                                                • The Social Wall: May 2025

                                                                                                                  Hey everyone, We're excited to share some powerful updates for the month of May! Let's take a look! Reply to your Instagram and Facebook comments privately through direct messages Are you tired of cluttered comment threads or exposing customer queries
                                                                                                                • Sub-Form Fields as Filters for Reports

                                                                                                                  Hi, I would like to use the Sub-Form Fields as Filters in Reports just like we do for Main Page Fields. Thanks Dan
                                                                                                                • Zoho CRM Formula - Current Time minus Date/Time field

                                                                                                                  Hello, I am trying to prevent duplicate emails going to clients when more than 1 deal is being updated. To do this, I would like to create a formula to identify if a date/time field is >= 2 hours ago. Can someone please help me write this formula? Example:
                                                                                                                • Billing Management: #7 Usage Billing in Telecom & Internet Service Provider

                                                                                                                  Telecom and Internet Service Providers operate in markets where usage varies drastically from one customer to another. While flexible, usage-based models align revenue directly with consumption, they also introduce operational challenges like real-time
                                                                                                                • Zoho Sprints - Q3 updates for 2025

                                                                                                                  The updates for the third quarter of 2025 are out. A few significant features and enhancements have been rolled out to improve user experience and product capabilities. The following are the updates: Manage tags and cluster tags Record and maintain project
                                                                                                                • Kaizen #208 - Answering your Questions | Functions, AI and Extensions

                                                                                                                  Hello Developers! Welcome back to a fresh week of Kaizen! We are grateful for your active participation in sharing feedback and queries for our 200th milestone. This week, we will answer the queries related to Functions and Extensions in Zoho CRM. 1.
                                                                                                                • Zoho CRM still doesn't let you manage timezones (yearly reminder)

                                                                                                                  This is something I have asked repeatedly. I'll ask once again. Suppose that you work in France. Next month you have a trip to Guatemala. You call a contact there, close a meeting, record that meeting in CRM. On the phone, your contact said: "meet me
                                                                                                                • Creating Restaurant Inventory Management on Zoho

                                                                                                                  Hi,  We run a small cloud kitchen and are interested to use Zoho for Inventory and Composite Item tracking for our food served and supplied procured to make food items.  Our model is basically like subway where the customer can choose breads, veggies,
                                                                                                                • To Zoho customers and partners: how do you use Linked Workspaces?

                                                                                                                  Hello, I'm exploring how we can set up and use Linked Workspaces and would like to hear from customers and partners about your use cases and experience with them. I have a Zoho ticket open, because my workspace creation fails. In the meantime, how is
                                                                                                                • Zoho Forms to Zoho CRM : First/Last Name to just Name ?

                                                                                                                  When integrating a Zoho Form into the Accounts menu of the CRM I'm having trouble with how names are formatted ; In Forms the data is available as First Name or Last Name In the CRM there is only one field called Name How can I ensure that "John" "Smith"
                                                                                                                • This festive season, offer discounts with coupon code support in Stripe Checkout

                                                                                                                  Hello form builders! It’s the festive season, the perfect time to spread joy and great deals! Now, with Zoho Forms’ latest enhancement for Stripe Checkout, you can do exactly that with coupon codes! Your payment forms integrated with Stripe Checkout can
                                                                                                                • Cómo creo una factura negativa o de abono?

                                                                                                                  NEcesito anular una factura y crear una nueva igual pero en negativo. El sistema no me lo permite
                                                                                                                • Power of Automation::Streamline log hours to work hours upon task completion.

                                                                                                                  Hello Everyone, A Custom Function is a user-written set of code to achieve a specific requirement. Set the required conditions needed as to when to trigger using the Workflow rules (be it Tasks / Project) and associate the custom function to it. Requirement:-
                                                                                                                • CRM : Function to add user name to text field

                                                                                                                  I have a lookup field in a module that is linked to the CRM users so we can assign a Project Lead to the customer. Sadly Zoho Marketing Automation doesn't sync Lookup fields so I need to extract information from the lookup to text fields: Lookup field
                                                                                                                • Zoho CRM - Restrict Login based on work hours

                                                                                                                  Hi there, I'm wondering if we can restrict users to login during works - For example the users would be able to login from 8am to 5pm. I have seen the IP address restriction - the only downfall is what if the customer has dynamic IP. thanks Jiri
                                                                                                                • Tips and Tricks #46: Customize themes and templates using Show's Master View

                                                                                                                  Hi All!  Let's say you want to revamp your presentation and make changes to its visual design. You can do this easily using the Master Slide and its associated layouts. The Master Slide stores information about all the layouts used in the presentation.
                                                                                                                • Sheet View in CRM portal

                                                                                                                  Hi, When will it be possible for my CRM portal users to edit/add records with Sheet View? George
                                                                                                                • What's New in Zoho Invoice | July - September 2025

                                                                                                                  Hello everyone! We’re back with the latest updates and enhancements we’ve rolled out in Zoho Invoice from July to September 2025. Here’s what’s new this quarter: Introducing the Singapore Edition in Zoho Invoice Share Invoices through WhatsApp GST 2.0
                                                                                                                • Alert: Audio Call Support to be discontinued for Old Live Chat Widget from December 31, 2025

                                                                                                                  Action Required: Upgrade to the New SalesIQ Live Chat Widget We're reaching out with an important update regarding the SalesIQ Live Chat Widget that requires your immediate attention. Effective December 31, 2025, audio call functionality will no longer
                                                                                                                • multiple contacts for one account

                                                                                                                  We currently use Zoho CRM where each Account represents a club or organization, and each Contact represents a manager or owner. However, some of our managers own or manage multiple clubs, and Zoho only allows a contact to be linked to one account at a
                                                                                                                • Rich text Merge field - Not using font specified in HTML

                                                                                                                  I have a rich text merge field in a writer template which is creating a table. I have chosen to use this method instead of a repeat region because I need to specify specific cell background colours which change every time the document is created. The
                                                                                                                • ヒートマップ詳細設定について

                                                                                                                  はじめまして マーケティング担当の浅田です。 PageSenceのヒートマップ設定について質問です。 単一ページ毎の設定は上手くできるのですが 詳細設定にて、トップページのURLを含ませ全体のヒートマップを計測できないか試したところ お知らせ:データを受信していません。と表示されてしまいます。 トップページURLで始まるページの条件も試しております。 全頁を反映させたいと思い、詳細設定を上手く設定できたらと考えております。 どなたか詳しい方がいらっしゃいましたら、教えて頂けませんでしょうか 宜
                                                                                                                • Automatic category assignment

                                                                                                                  Hi, I’d like to ask if there is a way to automatically assign an expense category based on the recognized Merchant. What would be the simplest way to set up automatic category assignment? Alternatively, is there an option to first choose the category
                                                                                                                • Experience with Zoho Vertical Studio

                                                                                                                  I'm considering Zoho Vertical and would love to hear from some devs who've been using it. The Zoho ecosystem is pretty solid, so I assume the experience has been pretty good, but sometimes Zoho has its quirks. Overall, has your experience been positive?
                                                                                                                • LinkedIn Chrome Extension

                                                                                                                  Hello - I believe it is a known issue that the LinkedIn extension Resume Extractor has stopped working and they are working on potential fixes. Wondering how others users are finding this issue and if there are any better workarounds for this issue? It
                                                                                                                • Advance PDF creation from CRM data

                                                                                                                  I'm trying to create a PDF export of data in the CRM. My problem is I want a pretty complicated format for the data. I'm trying to export multiple modules worth of data, with nested one-to-many relationships between the modules. Along with that, I want
                                                                                                                • More Formula Functions

                                                                                                                  Hi, I would like for example to be able to have a Date Field and Formula Fields, and then in the Formula Fields I would like to grab just the Month of the above Date Field or the Week Number of the above Date Field. So more "Functions" than the current
                                                                                                                • File upload size limits

                                                                                                                  I am designing a contact form in Zoho Creator with File upload facility. I am not sure where and how to set the following properties for the same: Allowed File Types Maximum Size of the Attachment Number of Attachments
                                                                                                                • Next Page