Skip to main content
The Zoho CRM integration allows you to update leads based on Zoho CRM deal events.
The Zoho CRM integration is quite difficult to set up. If you are having trouble or would like us to help you set it up, please contact us via [email protected].

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 on Create new connection.
Zoho CRM Step 3
  1. Select Custom Services and click on Create New Service.
Zoho CRM Step 4
  1. Here we are creating a new service. We give it 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. Then give the connection a name. Here we give it the name Octanist. and click on Create And Connect.
Zoho CRM Step 6 6.1. 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 Pn
  • Click Connect.
Zoho CRM API Key
  1. Search for webhooks and click Configure Webhook.
Zoho CRM Step 7
  1. Now we will create a new webhook. Here are the fields we need to fill in:
  • 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}"
}
  • Save
This is super important to get right. If any of these fields are incorrect, the webhook will not work and leads will not be correctly updated in Octanist.
Zoho CRM Step 8
  1. Search for workflow rules and select Rules. On the page click on Create Rule.
Zoho CRM Step 9
  1. You will see this popup. Give the following information:
  • Module: select Deals.
  • Rule Name: give it a name that is easy to identify, such as Octanist.
Zoho CRM Step 10
  1. When creating a rule. 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 select the webhook we created earlier.
Zoho CRM Step 13
  1. Click Save.
Zoho CRM Step 14 Now the Zoho CRM integration is set up from Zoho CRM side. Next we need to 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. Add a Name: give it a name that is easy to identify, such as Octanist - Zoho CRM Integration.
  2. For each of the stages select the name of the stage as it is in Zoho CRM.
Zoho CRM Step 16
  1. Enter fallback values when the amount field is not present.
  2. Then click Create Zoho CRM Integration.
Zoho CRM Step 17

Important

You’re all set! Please test by moving a deal within Zoho CRM. If you have any questions about this setup, contact us via [email protected].