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.
- Deluge functions
- Direct API calls
- 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.
- Check whether you need to migrate your user's access tokens or re-authenticate with a new permission.
- Familiarize yourself with the new v2 syntax. API v2.0 accepts only JSON input.
- Familiarize yourself with the changes in field attributes and field formats. The same is mentioned in the help document: Differences - v1 and v2.
- Take a look at the API methods available in v1 and how different they are in v2 here.
- Update the error handling in your app to utilize v2 errors with proper status codes.
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
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
Shylaja S
dan
Praveen Sankar
Amit Kumar Ranjan
Geof Baker
Sticky Posts
Client Script | Update - Introducing Commands in Client Script!
Have you ever wished you could trigger Client Script from contexts other than just the supported pages and events? Have you ever wanted to leverage the advantage of Client Script at your finger tip? Discover the power of Client Script - Commands! CommandsKaizen #165 : How to call Zoho CRM APIs using Client Script
Welcome back to another exciting Client Script post! In this post, we will discuss one of the most frequently asked questions: How do you call Zoho CRM APIs from Client Scripts? In this kaizen post, 1. Ways to make calls to Zoho CRM APIs using ClientKaizen#162 : Add Tags and Open Pre-filled Email Drafts via Client Scripts
Hello everyone! Welcome to another informative Kaizen post. In this post, let us see how to accomplish the following using Client Script. 1. How to auto-tag a record based on field update? 2. How to Open a pre-filled email draft This post will provideExtension Pointers - JS SDK series #4: Managing data from a widget using ZOHO.CRM.HTTP
Handling and managing the data between two applications is a major factor for an efficient business. There are a variety of ways to handle data between Zoho CRM and other third-party applications. You can use deluge CRM tasks, create connectors, use APIKaizen #152 - Client Script Support for the new Canvas Record Forms
Hello everyone! Have you ever wanted to trigger actions on click of a canvas button, icon, or text mandatory forms in Create/Edit and Clone Pages? Have you ever wanted to control how elements behave on the new Canvas Record Forms? This can be achieved
New to Zoho TeamInbox?
Zoho TeamInbox Resources
Zoho DataPrep 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
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
in zoho books while categorizing need to add new name in category by replacing expanses how to edit or make changes need assistance
Function #61: Automatically add free item to the invoice based on item quantity
Hello everyone, and welcome back to another Custom Function Friday! During holiday seasons or special promotions, businesses offer deals like BOGO (Buy One, Get One), Buy 3 Get 1 Free, Buy 2 at 50% off, and much more to attract customers. These promotionsRegarding GST Report Issue in Zoho Books
Hi, Right now, the very important point from my end is this Zoho Books issue. Here, you can see that we have created the invoice with the items of account sales and expenses. The journal is also correct. The profit and Loss statement is also correct.Multiple Salesperson against an invoice
Hello, Against a particular invoice, we have multiple sales people working. The reason we combine the invoice is becuase we are an exporter and often consolidate cargo for our customer to save them freight costs. How do I capture the contribution of eachProjectwise budget ---
Can we have a Project wise subject in addition to the Monthly, and quarterly ACCOUNT LEVEL budget?Looking back at Zoho Social's 2024: Highlights and memories
Hey everyone, We hope you had a relaxing and joyous holiday season. Whether you're planning for the new year or still soaking in the magic of the season, we're here to share some exciting highlights from 2024 – a year that was fully packed with updatesBuilding a Zoho Extension for Webex CC - Handling URL Changes
Hi everyone, I’m building a Zoho extension for Webex Contact Center (Webex CC) and facing an issue with handling URL changes. In telephony, I’ve set the URL of Webex CC to: https://desktop.wxcc-us1.cisco.com/ When this URL remains the same, everythingRemove County field from Customer Address input screen (or allow input to be deleted)
We are in the USA and have just noticed that there is now a County field in the Customer Address input screen (and maybe other areas of Zoho Books, but this is the one affecting us at the moment). County is not important to our business, and in fact weZoho still running very slow
I have a lead log for my company and creator seems to be running extremely slow still.Bigin API Token Request ("invalid_client")
Hi people, I tried to connect to the API without success, I've read all of the documentation multiple time and tried just about everything. I tried to do it with Python Request module and with Postman, passing the information through both the URL parameterShared Dashboard / Report Permissions : Read not Write
hi all, We are missing a huge fonctionnalite in setting up Dashboards (and reports) on corporate level. Currently, we can not set Read Permissions on share Dashboards (and reports) without giving write access as well When we create a corporate dashboardProfile stitching with Zoho Marketing Automation
When it comes to marketing, knowing who your audience is and tracking their interactions is vital. That's why Zoho Marketing Automation has taken a significant leap forward with its enhanced profile stitching feature. With this update, you can track yourGDPR
Hi , I'm checking out the HIPPA capabilities and at the moment I can see only three modules that can be selected to enable HIPPA Any idea how I can add additional modules such as customers? TNX Daviddefault task list for new project
Is there any way to have a default task list already created in a project, when the project is created in Zoho Books?Record less quantity than ordered in ZOHO inventory
Lets say I ordered 100 widgets from a Vendor. I have paid the Vendor month ago and just waiting for the product to ship. I have finally received the products but have only received 80 widgets. I see no way in ZOHO to only receive 80 widgets. ZOHO is forcingStripe payments via Books invoice link missing email - affects fraud detection
Hi, All our payments done via Books invoice link have a warning: Integration improvement available This transaction is missing customer email address, which affects fraud detection. Why doesn't Books pass this info to zohosecurepay.eu/books/... for morePower of Automation: Automatically sync custom field data between two tasks.
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:-'View Invoice' button hyperlink taking to Google Business Maps listing
The green "view invoice" button in my invoice emails is sending people to my Google maps business listing rather than the invoice. Both my clients and I are experiencing this as a new issue.Migrating Zoho emails to Google Workspace
Hi Is there a tool to migrate Zoho email to Google workspace?Custom Functions - Calculate Commission - failure after migration from US to EU
Hello, i would ask for help. My Custom Function - Calculate Commission stopped working and shows a failure. Mismatch of data type expression. Expected List but found String What is the problem? Could anyone help? Here is script: void automation.ObliczProwizje(IntGoCardless Mandate Sync Question
Hello, When syncing our customer database with GoCardless, some customers aren't working despite both email addresses matching in Zoho Books and GoCardless. Also what do we do about customers where they are associated with multiple accounts as these aren'tCreate a draft in reply to an email via Emails API
Hi, I’d like to use the outgoing webhook to automatically create a draft reply to incoming mail. How can I use the Emails API to create a draft reply that is linked to an existing email thread? I couldn’t find the relevant method in the documentation.Weekly Tips: Flags for an organized mailbox
Wishing you all a Happy New Year 🎉 As we step into 2025, it's time to refocus and set our intentions for the year straight. Whether you're already back at work or just returning from the holidays, you probably have emails that need your immediate attention,Edit line item amount
It would be sooooo much better to be able to edit the line item amount in all of the modules, if there is any variation in agreed prices it's extremely painful to calculate the rate to match ;-( The rate could be auto calculated on editing this field making life so much easier !Chanel Partner
Any Zoho channel partner or dubai based company who will help us for getting zoho services including the training for our staffRefer a Friend Campaign
I am looking to run a referral campaign that sees an initial email going to existing clients, asking them to refer a friend. For each new client referred, the existing client will get a ticket in a prize draw - the more new clients they refer, the more tickets they get in the draw. I am wanting to figure out how this could be done via Zoho, and how these referrals can be tracked and linked to the existing client who referred them.Emails cannot be received
Hey, There is an issue in my Zoho account, E-mails can be send from my side but cannot be received on my account MX, DCIM and other are added but still cant receive them. Please help me to solve this problem at your earliest convenience and this is happeningNewsletter in multiple languages
Hi We are planning on starting to use Zoho Campaigns for our newsletters. Since we send our newsletters in three languages, I would need the "unsubscribe page" and other pages related to the NL (Thank you page and so on) to be available in different languagesi couldn't recall message as one of the receptionists didn't received the message and i want to recall it urgent
i couldn't recall message as one of the receptionists didn't received the message and i want to recall it urgent as recall button doesn't appearServidores caidos?
Buenas, Hoy 30/12/2024, mi empresa esta sufriendo bastante problemas para acceder a las aplicaciones de Zoho. No sabemos si es solo nuestra compañia o esta afectado a todos. Cuando intentamos acceder a las aplicaciones nos salta el siguiente error: ATip #1- Remote support vs. unattended access: Contrasting two key concepts in tech assistance- 'Insider Insights'
Hello everyone! We, at Zoho Community, are excited to introduce Insider Insights, a new series where we will look into various aspects of remote support technology and how they might help you. We'll be sharing tips, methods, and insights acquired fromIntroducing Fair Evaluation for Interviews
Collaboration is key in recruitment, but it’s important to ensure individual interviewers’ assessments are not influenced by others. With Fair Evaluation, you can choose how and when interviewers can see reviews of a candidate for the same job opening.I have been looking for CVID to get segmate list where & how can fnd it?
I am trying to get segment details from the Zoho API. The API documentation says that the CVID is a mandatory parameter, but I cannot find the CVID in the "getmailinglists" API. Can you tell me where to find the CVID?"The data you have entered already exists" when trying to create contac@mydomain.com
Hi all, Our domain is ananasjuicebar.com. Working as admin in the control panel: When I try to add the email account "contact@ananasjuicebar.com" I get the error: "The data you have entered already exists" I've tried creating a new user or creating a new group with this address associated. To my knowledge this address has never been added and I can also not find any reference to it. (Shopify used this address to send customer notifications BEFORE setting up Zohomail.) Any ideas? are there any restrictionsTip of the week 03 - Sending emails in batches
Today's marketers not only want their email marketing to be efficient, but also smart. For an email campaign, you may think you have all the essential elements for lead conversion—a big mailing list, an attractive template design, and the most-engaging message content, but after hitting the ‘send’ button, you may not get the expected conversions. Wondering why? Here’s one of the major reasons. Many marketers miss out on sending the email campaign the right way. Did you know that you should not beZoho Books Bank Feed
Good afternoon, Is it possible to change the bank feed provider on a bank account. I'm using Plaid but think that Yodlee would be better in terms of pulling transactions in a timely manner. Thank you.Create Bill from Purchase Order via API
I know you can create a invoice from a Sales Order by using https://books.zoho.com/api/v3/invoices/fromsalesorder Is there a similar url for creating a bill from a purchase order?Log incoming calls on Android CRM?
I keep reading that I'm able to log incoming calls on the CRM app for Android, but when I answer a call and hang up, I never get the option to log. Is there a special admin I need to do for that? Or permissions? ThanksHow do i send an automated email 10 days after closing a ticket
I am trying to set up an automated email to the customer a set period after the ticket is closed. I have created the email template, but i cannot work out how to set the trigger to send this out. Can someone point me in the right direction please? IfDomain Verification
Hey, How do I know that my account is verified by Zoho? Do I need some zd code/number for it? Need help asap!Next Page