Connect Convert Forms with Zoho CRM

The Convert Forms ZohoCRM Integration is based on the ZohoCRM API v1 which has been deprecated since 31, Dec 2018 and it doesn't work anymore. We're currently working on a fix but there's no projected date yet when the will be available.

Until then, we recommend using Zapier to connect your forms with ZohoCRM and continue pushing your submissions. Learn How to connect Convert Forms with Zapier.

Convert Forms offers seamless integration with Zoho CRM. Connecting Convert Forms to Zoho CRM's Modules is surprisingly easy. Follow our step by step guide on how to connect Convert Forms with Zoho CRM below.

Addon Installation
Campaign Setup
Email & Other Fields
Assign form to Campaign

1. Addon Installation

Navigate to Components > Convert Forms > Addons
Click the Cog button for the Zoho CRM Addon. A popup will appear where you can enable the addon.

zoho crm convert forms addon

Click on the Status and select Enabled.
Now you can click on Save & Close button to save the enabled addon.

convert forms update plugin status

2. Campaign Setup

To setup a Campaign with Zoho CRM, follow the steps below.

Zoho CRM campaign convert forms

Navigate to Components > Convert Forms > Campaigns
Create a new Campaign by clicking New
Type a name for your Campaign. This name can not be seen by anyone else but you.
For the Sync Leads > Choose Service selectbox choose Zoho CRM . If you can not find the Zoho CRM option then you do not have the Zoho CRM Addon installed and activated. In that case, please go back to the top of the article and see how to install the mandatory addon.
Save the Campaign for the special Zoho CRM fields to show up.

The campaign options which will be available after the successful save are the following.

Name	Description
Authentication Token (Required)	The Authentication Token is a special alphanumeric string which is needed to identify your Joomla website with your Zoho CRM account. Read further below detailed instructions on how to obtain it.
Module	You can select one from three Zoho CRM modules to which you are going to save your Leads. Those are the "Leads" Module, the "Accounts" Module and the "Contacts" Module.
Update existing user	In case a subscriber with the same email changes his other data, you can set this option to "Yes" so that Zoho will get updated with the new data.
Trigger workflow	Depending on what you have set in Zoho to be done after a new Lead has been inserted, setting this option to "Yes" will set your rules into motion. The most common workflow is sending an automated welcome email to your new subscriber directly from Zoho.
Approval Mode	If you want to have a very fine control into which submissions do end up in your Zoho CRM account then setting this option to "Yes" will give you the opportunity to approve them first.

Generate Zoho CRM Authentication Token

To obtain your Zoho CRM Authentication Token you need to send an authentication request to Zoho by opening the following URL in your browser after you've replaced the [Username] and [Password] with your account's.

https://accounts.zoho.com/apiauthtoken/nb/create?SCOPE=ZohoCRM/crmapi&EMAIL_ID=[Username]&PASSWORD=[Password]

Once you open the URL on your browser you will be sent to a screen from which you can copy the Authentication Token just like in the screenshot below:

convert-forms-zohocrm-authentication-token

Now that you have the Authentication Token you can paste it in back into the Zoho CRM Campaign Settings in your Joomla.

In case you face any troubles with the Token generation you can find more details on the Zoho CRM official documentation page.

A last step is the Zoho CRM Module selection through which you can choose between Leads / Accounts / Contacts. The module that you will choose in the Integration Settings will be populated with the subscribers of your ConvertForms.

convert-forms-zohocrm-supported-modules

3. Email & Other Fields

Email

For a Convert Form to successfully store an email address to your Zoho CRM account it needs to have an email field. This field is already set up at the time of creating the form and you don't have to change its input value as it is already configured for you.

convert-forms-zohocrm-email-and-fields

With Zoho CRM you have a wide variety of other fields which can be populated depending on the Zoho CRM module that you have chosen. The lists below contain the field names that you can use.