Kaizen #106 - Functions and Invoke URLs - Part 2

Kaizen #106 - Functions and Invoke URLs - Part 2

Hello everyone! Welcome to Kaizen #106.
In continuation to our last post, today, we will discuss invoke URLs in functions, how they are different from integration tasks, and how authentication works for them.

What are invokeURL tasks?

invokeUrl task is a task designed to trigger HTTP API endpoints of Zoho apps or any external services. invokeUrl makes the authorization part much easier by setting up connectors.

How are invoke URLs authenticated?

Using Connections.
Connections allow you to connect to various third-party apps or other Zoho services. Connections essentially use the OAuth 2.0 protocol. It abstracts the entire OAuth2.0 authorization flow and keeps your code simple, clean, and crisp.
If you set up a connection once, and authorize it once, you can make API calls to and from the external system and Zoho CRM.
You can create a single connection for your org and other users of your org can use the same connection by authenticating it with their credentials. Other users of your org can use your connection. In such cases, your connection will appear as a "shared connection" in their accounts.
Similarly, if you use your credentials to authenticate a connection created by some other user, it will be listed under the "shared connections" of your account.
For more details on types of connections, refer to this page.

Default Services

Zoho CRM has integrated with various third-party apps and they are listed under Default Services. All you have to do is
  1. Go to Setup > Developer Space > Connections > Create Connection.
  2. Under "Pick your service", choose the app you want to connect to. Here, I have chosen Gsheet.
  3. Click Create Connection.
  4. Specify the Connection Name and choose the scopes from the list. Note that this will vary based on the service you choose.

  5. Click Create and Connect.
  6. You will be redirected to a screen asking for your consent to connect to the service.
  7. Provide your login credentials.
  8. Click Connect. You will be redirected to Zoho Flow's authentication page, asking for your consent to connect to the service and redirect you to the service's login page.

  9. On the service's login page, provide your credentials and login.
  10. The service shows a pop up explaining the data that Zoho flow will use through the connection.

  11. Click Allow.
  12. The connection will be created in Zoho CRM.

  13. The sample code contains the snippet of the invoke URL you must use in your function to use the Gsheet's endpoints.
By simply using the connection name in your code, you can connect to third-party apps without worrying about token generation or configuration.

Components of the invoke URL

url - The third party's API endpoint you want to access.
type - The type of API call it is going to be. Supports GET, POST, PUT and DELETE.
parameters - The body of the request.
connection - The name of the connection you want to use.
For more details on invoke URL task, refer to this page.

Custom Service

Use this option when the service you want to connect to is not listed under "Default Services".
To create a custom service and connect to it, you must give the details of the service like its name, authorization type, and other attributes, and take care of token generation.


Differences between integration tasks and invoke URLs

Integration Tasks
Invoke URLs
API wrappers to Zoho APIs. Can be called just like built-in functions.
HTTP requests that are triggered explicitly.
All integration task actions are triggered under the admin’s authorization.
All invokeUrl actions that are triggered pertain to the user that authorized the connection.

Here is a sample of a function using invoke URL and the connection named "mine".

headermap = map();
headermap.put("this goes in the header", "value");
paramMap = map();
paramMap.put("this goes in the body", "body");
info paramMap;
response = invokeUrl [
type: POST
headers: headermap
content-type: "application/json"
parameters: paramMap.toString()
connection: "mine"
];
info response;
return "";

Here is the response.


As you can see, as the connection is already authenticated using OAuth2.0, the connection directly supplies the access token.
We hope you found this post useful. Let us know what you think in the comments, or email us at support@zohocrm.com.

Cheers!




    Access your files securely from anywhere








                            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 #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
                                                            • Kaizen #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
                                                            • Kaizen #142: How to Navigate to Another Page in Zoho CRM using Client Script

                                                              Hello everyone! Welcome back to another exciting Kaizen post. In this post, let us see how you can you navigate to different Pages using Client Script. In this Kaizen post, Need to Navigate to different Pages Client Script ZDKs related to navigation A.
                                                            • Kaizen #210 - Answering your Questions | Event Management System using ZDK CLI

                                                              Hello Everyone, Welcome back to yet another post in the Kaizen Series! As you already may know, for the Kaizen #200 milestone, we asked for your feedback and many of you suggested topics for us to discuss. We have been writing on these topics over the


                                                            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

                                                                                                              • Allow syncing Activities from other applications

                                                                                                                Marketing Automation could be a much more powerful platform if you were able to sync activities into the platform (e.g. purchase, donation, etc) outside of a user doing something on your website. I'd love it if you could sync Custom CRM Modules as activities,
                                                                                                              • Global Sets for Multi-Select pick lists

                                                                                                                When is this feature coming to Zoho CRM? It would be very useful now we have got used to having it for the normal pick lists.
                                                                                                              • Integración Books para cumplir la ley Crea y Crece y Ley Antifraude (VeriFactu)

                                                                                                                Hola: En principio, en julio de 2025, entra en vigor la ley Crea y Crece y Ley Antifraude (VeriFactu). ¿Sabéis si Zoho va a cumplir con la ley para cumplir con la facturación electrónica conectada a Hacienda? Gracias
                                                                                                              • Ask the Experts #1

                                                                                                                Hello everyone! It’s time to transform how you manage projects. Define the processes. Automate the tasks. Streamline the workflows. Let us dive into automation in Zoho Projects — from configuring workflows and custom functions to building triggers, using
                                                                                                              • How to overcome Zoho Deluge's time limit?

                                                                                                                I have built a function according to the following scheme: pages = {1,2,3,4,5,6,7,8,9,10}; for each page in pages { entriesPerPage = zoho.crm.getRecords("Accounts",page,200); for each entry in entriesPerPage { … } } Unfortunately, we have too many entries
                                                                                                              • Checking if Creator has Change History

                                                                                                                Like zForms - whenever an entry was updated there's an option to attached change history to email notif. Trigger -> Successful form submission
                                                                                                              • how to use validation rules in subform

                                                                                                                Is it possible to use validation rules for subforms? I tried the following code: entityMap = crmAPIRequest.toMap().get("record"); sum = 0; direct_billing = entityMap.get("direct_billing_details"); response = Map(); for each i in direct_billing { if(i.get("type")
                                                                                                              • Adding contact role to a specific deal js sdk malfunctioning

                                                                                                                i was trying to add the contact role to a specific deal contact but repeatedly i am getting this error: { "code": "SUCCESS", "details": { "statusMessage": { "code": "INVALID_DATA", "details": { "expected_data_type": "jsonobject" }, "message": "body",
                                                                                                              • Q3 Updates from Bigin!

                                                                                                                Hey Biginners, Hope you’re doing great! As we approach the end of 2025, we truly hope Bigin has been a part of helping you build your dream business this year! We've been busy working behind the scenes to bring you features that make running your business
                                                                                                              • Client Script | Update - Introducing Subform Events and Actions

                                                                                                                Are you making the most of your subforms in Zoho CRM? Do you wish you could automate subform interactions and enhance user experience effortlessly? What if you had Client APIs and events specifically designed for subforms? We are thrilled to introduce
                                                                                                              • {"errors":[{"id":"500","title":"Servlet execution threw an exception"}]}

                                                                                                                Here's the call to move a file to trash. The resource_id is accurate and the file is present. header = Map(); header.put("Accept","application/vnd.api+json"); data = Map(); data_param1 = Map(); att_param1 = Map(); att_param1.put("status",51); data_param1.put("attributes",att_param1);
                                                                                                              • Converting Sales Order to Invoice via API; Problem with decimal places tax

                                                                                                                We are having problems converting a Sales Order to an Invoice via API Call. The cause of the issue is, that the Tax value in a Sales Order is sometimes calculated with up to 16 decimal places (e.g. 0.8730000000000001). The max decimal places allowed in
                                                                                                              • Zoho Canvas - Custom templates for related lists

                                                                                                                Hi, I see that the example pages load always one of our related lists in a custom template, but I dont know how to work with that:  1) How can i make my own custom templates for related lists?  2) Where and how can i check out existing custom templates?
                                                                                                              • Kaizen #147 - Frequently Asked Questions on Zoho CRM Widgets

                                                                                                                Heya! It's Kaizen time again, folks! This week, we aim to address common queries about Zoho CRM Widgets through frequently asked questions from our developer forum. Take a quick glance at these FAQs and learn from your peers' inquiries. 1. Where can I
                                                                                                              • open word file in zoho writer desktop version

                                                                                                                "How can I open a Microsoft Word (.doc or .docx) file in Zoho Writer if I only have the file saved on my computer and Zoho Writer doesn't appear as an option when I try 'Open with'? Is there a way to directly open the .doc file in Zoho Writer?"
                                                                                                              • Zoho PDF editor has a lot of issues.

                                                                                                                Zoho PDF editor needs a lot of work. It hangs and glitches a lot. Deletes annotations and clearings randomly.
                                                                                                              • Syncing contacts on Android

                                                                                                                I'm using the Zoho mail app on Android and although I can see my contacts from within the app, they're not synced to my native contact list and so I can't access them from within the native dialer. Is there any way that I can sync my contacts into my native address book? Regards, Martin
                                                                                                              • Zohom mail

                                                                                                                Plz resolve the problem . I hope u understand .
                                                                                                              • Zoho sheet desktop version

                                                                                                                Hi Zoho team Where can I access desktop version of zoho sheets? It is important as web version is slow and requires one to be online all the time to do even basic work. If it is available, please guide me to the same.
                                                                                                              • ZOHO SHEETS

                                                                                                                Where can I access desktop version of zoho sheets? It is important to do basic work If it is available, please guide me to the same
                                                                                                              • Using Zoho Flow to create sales orders from won deal in Zoho CRM

                                                                                                                Hi there, We are using Zoho Flow to create sales orders automatically when a deal is won in Zoho CRM. However, the sales order requires "Product Details" to be passed in "jsonobject", and is resulting in this error: Zoho CRM says "Invalid input for invalid
                                                                                                              • Is Zoho Sheet available for Linux ?

                                                                                                                Is Zoho Sheet available for Linux ?
                                                                                                              • Bharat

                                                                                                                a
                                                                                                              • how to disable staff selection Zoho Booking integrated to SalesIQ?

                                                                                                                currently there is only one Consultant in my Zoho Bookings like this I integrate Zoho Bookings into Zoho SalesIQ to create a chatbot. Unfortunately, even though I only have one consultant for a consultation, the user have to pick the consultant. It will
                                                                                                              • Zoho Bookings No Sync with Outlook

                                                                                                                Zoho Bookings appointments are showing on my Outlook Calendar but Outlook events are not showing on Zoho Bookings. How do I fix this?
                                                                                                              • End Date in Zoho Bookings

                                                                                                                When I give my appointments a 30 minutes time I would expect the software not to even show the End Time.  But it actually makes the user pick an End Time.  Did I just miss a setting?  
                                                                                                              • Custom confirmation message

                                                                                                                How can I change the message that users see after they submit the booking form? I have to confirm some details before their appointment is officially "confirmed", so I want to change it where it doesn't say their appointment is "confirmed" but rather
                                                                                                              • Issue showing too many consultations in my workspace link.

                                                                                                                Hi Team, I’ve set up two Workspaces to track meetings from different sources. So far, this has been working well, and the two Workspaces are differentiated without any issues. However, when I navigate to Consultations and share the link to my personal
                                                                                                              • Deluge sendmail in Zoho Desk schedule can't send email from a verified email address

                                                                                                                I am trying to add a scheduled action with ZDesk using a Deluge function that sends a weekly email to specific ticket client contacts I've already verified the email address for use in ZDesk, but sendmail won't allow it in its "from:" clause. I've attached
                                                                                                              • unblock e-mail

                                                                                                                please unblock my e-mails info@meatnews.gr and myrtokaterini@meatnews.gr
                                                                                                              • Changing Corporate Structure - How Best to Adapt Current and Future Zoho Instances

                                                                                                                My current company is Company A LLC with a dba ("doing business as" - essentially an alias) Product Name B. Basically, Company A is the legal entity and Product Name B is what customers see, but it's all one business right now. We currently have a Zoho
                                                                                                              • How to Install Zoho Workdrive Desktop Sync for Ubuntu?

                                                                                                                Hi. I am newbie to Linux / Ubuntu. I downloaded a tar.gz file from Workdrive for installing the Workdrive Desktop Sync tool. Can someone give me step by step guide on how to install this on Ubuntu? I am using Ubuntu 19.04. Regards Senthil
                                                                                                              • How to upload own video?

                                                                                                                How can you upload your own video on your zoho website? I do not want to use another host, but i want to insert my own files. how can i do this?
                                                                                                              • Support new line in CRM Multiline text field display in Zoho Deluge

                                                                                                                Hi brainstrust, We have a Zoho CRM field which is a Muti Line (Small) field. It has data in it that has a carriage return after each line: When I pull that data in via Deluge, it displays as: I'm hoping a way I can change it from: Freehand : ENABLED Chenille
                                                                                                              • Announcing new features in Trident for Windows (v.1.32.5.0)

                                                                                                                Hello Community! Trident for Windows just got better! This update includes new features designed to improve and simplify email and calendar management—and it includes a feature you’ve been waiting for. Let’s dive into what’s new! Save emails in EML or
                                                                                                              • How to render either thumbnail_url or preview_url or preview_data_url

                                                                                                                I get 401 Unauthorised when using these urls in the <img> tag src attribute. Guide me on how to use them!
                                                                                                              • Zoho CRM Calendar | Custom Buttons

                                                                                                                I'm working with my sales team to make our scheduling process easier for our team. We primary rely on Zoho CRM calendar to organize our events for our sales team. I was wondering if there is a way to add custom button in the Calendar view on events/meeting
                                                                                                              • Create Lead Button in Zoho CRM Dashboard

                                                                                                                Right now to create Leads in the CRM our team is going into the Lead module, selecting the "Create Lead" button, then building out the lead. Is there anyway to add the "Create Lead" button or some sort of short cut to the Zoho CRM Dashboard to cut out
                                                                                                              • Searching customer field

                                                                                                                Hello, When entering a receipt, we select customer information. The customer information is synced with Zoho CRM. However, we can't find the customer information because it searches for words that begin with the entered value. It needs to search for words
                                                                                                              • Introducing Version-3 APIs - Explore New APIs & Enhancements

                                                                                                                Happy to announce the release of Version 3 (V3) APIs with an easy to use interface, new APIs, and more examples to help you understand and access the APIs better. V3 APIs can be accessed through our new link, where you can explore our complete documentation,
                                                                                                              • Next Page