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

Go to Setup > Developer Space > Connections > Create Connection.
Under "Pick your service", choose the app you want to connect to. Here, I have chosen Gsheet.
Click Create Connection.
Specify the Connection Name and choose the scopes from the list. Note that this will vary based on the service you choose.
Click Create and Connect.
You will be redirected to a screen asking for your consent to connect to the service.
Provide your login credentials.
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.
On the service's login page, provide your credentials and login.
The service shows a pop up explaining the data that Zoho flow will use through the connection.
Click Allow.
The connection will be created in Zoho CRM.
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 [

url: "https://xxx.net/"

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!

New to Zoho LandingPage?

Access Zoho LandingPage

Zoho LandingPage Resources

New to Zoho Survey?

Access Zoho Survey

Latest Feature Updates

Explore our Pricing & Plans

Zoho Survey Resources

Android Mobile Surveys

Insurvey Blogs

Insight Blogs

Tips & Tricks

New to Zoho CRM Plus?

Deliver unforgettable customer experiences

ACCESS ZOHO CRM PLUS

New to Zoho CRM Plus?

Deliver unforgettable customer experiences

ACCESS ZOHO CRM PLUS

New to Zoho Marketing Plus?

Everything you need to run your marketing

ACCESS ZOHO MARKETING PLUS

New to Zoho Marketing Plus?

Everything you need to run your marketing

ACCESS ZOHO MARKETING PLUS

New to Bigin?

Signup Now

Access Bigin

Latest Feature Updates

Zoho Desk Resources

Desk Community Learning Series
Digest
Functions
Meetups
Kbase
Resources
Glossary
Desk Marketplace
MVP Corner
Word of the Day

Tout forum

France ZUGs

Zoho SalesIQ Resources

Sticky Posts
Extension pointers for integrating Zoho CRM with Zoho products #8: Upload and manage Zoho Workdrive folders and files from within Zoho CRM
Keeping records on your customers and business prospects is essential for tracking data, conducting follow-ups, and running a business smoothly. When you use two separate applications, and store relevant data in each, checking and tracking data becomes
Extension pointers: Handle cases with personalized solutions using custom actions
In our last post, we detailed the steps involved in creating a custom action and the workflow from the developer and end user's side. Now let's look at a working example of how we can create a custom action and implement it in a Zoho CRM account to make
Extension pointers - Simple yet significant pointers #13: On change of field value for CRM variables
CRM variables provide global access to a variable across an entire extension. They also help in the storage of user-specific data provided by the user at the time of installation, which can later be fetched to perform data functionalities. Additionally,
Extension pointers: Extend end-user benefits and allow personalization by implementing extensions with custom actions
From our earlier post on custom actions, we know that we can create templated actions, share them with end users, and allow them to reuse those actions to achieve personalized outcomes. In this post, we'll look at how custom actions make it easy for users
Extension pointers - Simple yet significant pointers #12: Functions for Zoho CRM extensions
Functions are essential in achieving logical functionality for an extension. You can easily code your functions in Deluge using drag-and-drop tools to meet your requirements. How to create functions for Zoho CRM extensions in Sigma Go to Sigma and select