Skip to main content
The Zoho CRM integration allows you to update leads based on Zoho CRM deal events.
The Zoho CRM integration can be complex to set up. If you are having trouble or would like assistance, please contact us at support@octanist.com.

Table of Contents

  1. Zoho CRM
  2. Octanist

1. Zoho CRM

Zoho CRM Step 1
  1. Go to Zoho CRM and log in. Click the Settings icon in the top-left corner.
  2. In the left sidebar, search for Connections and click on it.
Zoho CRM Step 2
  1. Click Create New Connection.
Zoho CRM Step 3
  1. Select Custom Services and click Create New Service.
Zoho CRM Step 4
  1. Create a new service with the following details:
    • Name: give it a name that is easy to identify, such as Octanist.
    • Authentication Type: select API Key.
    • Parameter Type: select Header.
    • Parameter Key: enter X-API-KEY.
    Then create the new service.
Zoho CRM Step 5
  1. Give the connection a name (e.g., Octanist) and click Create And Connect.
Zoho CRM Step 6 You will be prompted to enter your API key.
  • You can find this in Octanist → Settings → General → API Key.
  • Create a new API key and give it a clear and descriptive name. Zoho CRM Get API Key Octanist
  • Click Connect.
Zoho CRM API Key
  1. Search for Webhooks and click Configure Webhook.
Zoho CRM Step 7
  1. Create a new webhook with the following fields:
    • Name: give it a name that is easy to identify, such as Octanist.
    • Method: select POST.
    • URL to Notify: enter https://octanist.com/api/integrations/updating/zoho/
    • Authorization Type: select Connection and choose the connection you created.
    • Module: select Deals.
    • Body:
      • Type: select Raw.
      • Format: select JSON.
      • Content: enter the following JSON:
{
  "amount": "${Deals.Amount}",
  "stage": "${Deals.Stage}",
  "contact_email": "${Contacts.Email}",
  "contact_phone": "${Contacts.Phone}"
}
  • Click Save.
It is important to get these fields right. If any are incorrect, the webhook will not work and leads will not be updated correctly in Octanist.
Zoho CRM Step 8
  1. Search for Workflow Rules and select Rules. On the page, click Create Rule.
Zoho CRM Step 9
  1. In the popup, enter the following:
    • Module: select Deals.
    • Rule Name: give it a name that is easy to identify, such as Octanist.
Zoho CRM Step 10
  1. For the WHEN step, choose the following options:
    • Execute this workflow rule based on: select Record action.
    • Then select Edit and Specific field(s) get modified.
    • When: Stage is modified to any value.
    • Click Next.
Zoho CRM Step 11
  1. Select All Deals and click Done.
Zoho CRM Step 12
  1. For the action, select Webhook and choose the webhook created in step 8.
Zoho CRM Step 13
  1. Click Save.
Zoho CRM Step 14 The Zoho CRM side of the integration is now complete. Next, set it up in Octanist.

2. Octanist

  1. Go to Octanist and navigate to Integrations > Updating > Add New.
  2. Choose Zoho CRM and click Add Integration.
Zoho CRM Step 15
  1. For each stage, enter the exact stage name as it appears in Zoho CRM.
    • Example - Qualified Stage Name: Proposal
    • Example - Closed Won Stage Name: Closed Won
    Use the exact stage name from your Zoho CRM.
Octanist Add Zoho Integration Stages
You can find the stage names in Zoho CRM as shown below: Zoho CRM Step 16
  1. Set the values for each lead stage:
    • Example - Qualified Lead (high-potential client): 1000
    • Example - Won Lead (purchased your product or service): 5000
Zoho Integration Add Values
  1. Finally, complete the integration by giving it a descriptive name.
Octanist Add Zoho Integration Finalize

You are all set! Please test the integration by moving a deal within Zoho CRM. If you have any questions about this setup, contact us at support@octanist.com.