​
Setup Guide

You can find your Zoho CRM app credentials in your Zoho CRM Developer Account. You’ll need the following information to set up your Zoho CRM App with Paragon Connect:
  • Client ID
  • Client Secret
  • Scopes Requested

​
Creating a Zoho CRM app

​
Add the Redirect URL to your Zoho CRM app

Paragon provides a redirect URL to send information to your Zoho CRM app. To add the redirect URL to your Zoho CRM app:
  1. Copy the link under “Redirect URL” in your integration settings in Paragon. The Redirect URL is:
https://passport.useparagon.com/oauth
  1. Visit the Zoho API Console.
  2. Sign in with your Zoho CRM Developer Account.
  3. Click “Add Client” in the top right:
  1. Select “Server-based Applications” as the Client Type:
  1. Add your website as the Homepage URL.
  2. Paste-in the Redirect URL Paragon provides as an Authorized Redirect URI.
Zoho CRM provides you with the Client ID and Client Secret needed for the next steps after adding the redirect URL to your app.

​
Add your Zoho CRM app to Paragon

Under Integrations > Connected Integrations > Zoho CRM > Settings, fill out your credentials from your developer app in their respective sections:
  • Client ID: Found at the end of Step 1 on your Zoho CRM App page.
  • Client Secret: Found at the end of Step 1 on your Zoho CRM App page.
  • Permissions: Select the scopes you’ve requested for your application. For a list of recommended scopes, please view this integration within your Paragon dashboard. View dashboard.
Leaving the Client ID and Client Secret blank will use Paragon development keys.

​
Connecting to Zoho CRM

Once your users have connected their Zoho CRM account, you can use the Paragon SDK to access the Zoho CRM API on behalf of connected users. See the Zoho CRM REST API documentation for their full API reference. Any Zoho CRM API endpoints can be accessed with the Paragon SDK as shown in this example. 
// You can find your project ID in the Overview tab of any Integration

// Authenticate the user
paragon.authenticate(<ProjectId>, <UserToken>);

// Retrieve the user's data
await paragon.request("zohocrm", "users", {
  method: "GET",
});
            
// Add a user to your organization
await paragon.request("zohocrm", "users", {
  method: "POST",
  body: {
    "users": [
      {
        "role": "554023000000015969",
        "first_name": "Patricia",
        "email": "[email protected]",
        "profile": "554023000000015975",
        "last_name": "Boyle"
      }
    ]
  }
});

​
Building Zoho CRM workflows

Once your Zoho CRM account is connected, you can add steps to perform the following actions:
  • Create Record
  • Update Record
  • Get Record by ID
  • Search Records
  • Delete Record
  • Search Records by COQL Query
When creating or updating records in Zoho CRM, you can reference data from previous steps by typing {{ to invoke the variable menu.

​
Using Webhook Triggers

Webhook triggers can be used to run workflows based on events in your users’ Zoho CRM account. For example, you might want to trigger a workflow whenever new Accounts are created in Zoho CRM to sync your users’ Zoho CRM Accounts to your application in real-time. You can find the full list of Webhook Triggers for Zoho CRM below:
  • New Record
  • Record Updated