Jump to a Section

Overview

Parameters

  1. Connection Nickname - Enter a connection nickname. This is a display name for this connection. Use clear naming conventions so that in the future it is clear which account the connection is associated with.

Zoho CRM uses Oauth2 for authentication; after entering your nickname, click the create button. An OAuth window opens asking for your Zoho CRM username and password.

Enter your Zoho CRM account information, then click Sign In. You will be asked to allow Azuqua to access your Zoho CRM account. Click Authorize. You should then be redirected back to Azuqua, with a successful connection to Zoho CRM.

IMPORTANT NOTE: It is recommended that you only create one Azuqua connection per Zoho CRM user. This is due to a limitation of the Zoho CRM API. Currently the API will only provision one refresh token per user. This means that if there are multiple connections per user, then it is likely that one of the connections will have the tokens invalidated, which will result in an error from Zoho. The following errors suggest symptoms of the above:

  • INVALID_TOKEN
  • invalid auth token
  • Unauthorized

    Actions

    • Custom API Action

      Make a custom HTTP request to the Zoho CRM API.

      Zoho CRM API documentation: https://www.zoho.com/crm/help/api/v2. Ensure that you are using V2 of the API version.

      • GET: retrieves data from a web server based on your parameters. GET requests a representation of the specified resource, and if successful will receive a 200 OK response message with the requested content. Additional documentation here.

      • POST: sends data to a web server based on your parameters. POST requests include actions like uploading a file. Multiple POST’s may result in a different outcome than a single POST, so you should be cautious about unintentionally sending multiple POST’s. Additional documentation here.

      • PUT: sends data to a location in the web server based on your parameters. PUT requests include actions like uploading a file. The difference between a PUT and POST is that PUT is idempotent, meaning that the result of a single successful PUT is the same as many identical PUT’s. Additional documentation here.

      • DELETE: deletes the specified resource from the web server based on your parameters (if the resource exists). Additional documentation here.

      Zoho CRM HTTP Method Information can be found here.

      Input Fields

      • Request

        • Relative URL (string) - Relative request URL. The relative URL structure for this action follows the /crm route. E.g. - If the full API URL is https://www.zohoapis.com/crm/v2/Leads, then the Relative URL would be /v2/Leads.

          Example: /v2/Leads
        • Query (object) - Query parmaeters for the request.

          Example: {"fields":"Last_Name,Email"}
        • Headers (object) - Headers for the request.

          Example: {"Accept":"application/json"}
        • Body (object) (only for POST, PUT, and DELETE) - Body of the request.

          Example: {"foo": "automation, "bar": "integration"}

      Output Fields

      • Response
        • Status Code (number) - The status code of the HTTP response. Here is a list of all status codes.
        • Headers (object) - The response headers. A more detailed context for the response/status code that doesn’t relate to the output body. Not all headers that appear in a response header are response headers, meaning that some are unlikely to be useful to you.
        • Body (object) - The response body. Depending on the HTTP request you chose in Options, you may receive some data back. That data, such as the data from a GET request, will be contained in this Body object.