OAuth authorization enablement and Other enhancements in Webhooks

OAuth authorization enablement and Other enhancements in Webhooks

Dear All,


We are deprecating the use of Authtokens and the same has been intimated in the Authtoken deprecation announcement. Further to the notification, we had also mentioned about the impact it has on the existing webhooks and migrating to OAuth authorization for continued communication with Zoho Applications.

Owing to this deprecation, we are now offering OAuth authorization type and a few other updates in Webhooks.

Webhooks are a low-code solution to transmit information from one application to another via a HTTPS protocol, to provide a seamless operational experience in any business. To authorize communication between applications, you can append webhooks with different authorization types like Authtokens, API keys, etc.

In this enhancement we are providing:
  • Additional Request Methods- PUT and DELETE.
  • New categories to choose the authorization type - General and Connection.
  • A categorization in URL parameter configuration - Header configuration and Body Configuration.
  • The feasibility to choose the input type in Body URL configuration - Form-Data and Raw Data.
Let's look at them in detail!

Additional Request Methods
So far we provided two types of request methods: GET and POST. We are now introducing PUT and DELETE methods as well. While GET and POST methods allow you to receive and send information between applications, PUT and DELETE methods allow you to update and delete the existing information respectively.

Introduction of Authorization Type
Up till now, authorizations like Authtokens was manually added to the webhooks and admins used to append it to the URL parameters optionally. While Authtoken is static and less secure, OAuth is dynamic and highly secure. Therefore, in our previous post we had recommended migration to OAuth authorization.

In this update, we are introducing OAuth as a new means of authorization along with the existing types such as API and Authtokens. We have categorized the authorization into 2 types:
  • General - allows you to set up basic or API authorization types like API Keys, AuthToken, etc..You can also skip configuring the authorization in the webhooks.
  • Connection - allows you to select the dynamic OAuth authorization from existing connections in Zoho CRM or set up a new connection.

Please note, establishing correspondence with other Zoho applications using webhooks, henceforth requires OAuth authorization. Refer to our help doc to understand how to work with connection.

The aforementioned deprecation of authtoken is scheduled to be deprecated soon. To avoid webhook breakage, users can migrate the existing Authtoken to OAuth before the deprecation. Follow this post for further intimation about deprecation.

To migrate your existing webhooks with Authtoken to OAuth,
  • Navigate to the Set up > Automations > Actions > Webhooks.
  • Click on the webhook that needs to be migrated.
  • Click Edit in the top-right corner.
  • Select Connection as the Authorization Type.
  • Choose the connection created for your Zoho app.
    • If you have not created a connection yet, click New Connection and select your Zoho service.
    • Enter the connection details and click Save.
    • On the Webhooks page, click the Refresh icon to see the new connection in the list, and select it
  • Click Save.
Categorization of Header and Body URL Parameters
To suit the industry standards, Webhooks that are sent from Zoho CRM now have a Header and Body structure.

You can configure the dynamic module parameters or manually feed the static custom parameters like API Key or Authtoken, etc..in the header section of the webhooks.

To configure the body parameters of the Webhooks, select the input type from the drop-down list,
  • None - It allows you to skip the body part configuration.
  • Form-data -It allows you to append information as Module Parameters, Custom parameters, or User-defined format
  • Raw - It allows you to type the webhook string in the subsequent text editor manually. The supported Input format includes Text, HTML, JSON, and XML.

That's about the webhooks update.

If you have configured webhooks in your organization, you would have received an email about the deprecation and migration.

Kindly refer to our help doc to understand more about webhooks.

Thank you,
    • Sticky Posts

    • [Early Access - Updated to LIVE] Introducing the Canvas Design Studio.

      Greetings Customers!   Before we kick back and enjoy the holidays, we'd like to make a post about our next big thing. In January 2021, Zoho CRM will be launching its magnum opus for delivering world-class user experience - here's a sneak peek of what's
    • Introducing Multiple Sandbox Types and Support for Module's Data Population

      Register here for the upcoming Focus Group webinar on Multiple Sandbox | Help documentation to learn more about the new enhancements Hello everyone,  Sandbox in CRM is a testing environment for users to create and test new configurations like workflow
    • Include Finance Suite modules to Segment your records

      Dear All, Greetings! We have a quick update on Segmentation in Zoho CRM. Let's go! As you might know, Segmentation is a process of categorizing your customer records based on common patterns and behaviors. And, RFM is one such way to categorize customers
    • Focus Group Webinar - Integrating Zoho CRM and Zoho Analytics

      In addition to the Focus Group webinar on revamped reports in Zoho CRM, we're discussing and demoing how we can setup an integration between CRM and Analytics, and leverage these advanced functionalities contextually with CRM data. In addition to more
    • Zoho CRM Segmentation FAQ - Post your questions

      Hello, Greetings! We hope you are well. Segmentation is the primary step in Marketing to know and classify your target audience into groups based on their purchase pattern. In the best interest of your benefit, we have been publishing FAQs about segmentation

    Zoho CRM Plus Resources

      Zoho Books Resources

        Zoho Subscriptions Resources

          Zoho Desk Resources

            Zoho Projects Resources

              Zoho Sprints Resources

                Zoho Orchestly Resources

                  Zoho Creator Resources