Zoho CRM

Reading time: 2 minutes

Mautic - Zoho CRM plugin

Mautic can push a contact to Zoho CRM based on Campaign actions or Point Triggers.

Language configuration warning

Your Zoho and Mautic accounts must be configured with the English language, otherwise the synchronization won't work. Zoho changes the alias of each of the contact fields depending on the language, which generates unmatched fields and errors on sync.

Configure the Zoho CRM plugin

  1. Create a Zoho CRM account if you don't have one already.

  2. Generate a key pair by going to the Zoho Developers Console. You will need to select Server Based Applications and provide a name for the client; the URL of your Mautic instance, and the callback URL (which you can access by going to Plugins > ZohoCRM in Mautic and copying the callback URL, usually in the format https://mautic.example.com/plugins/integrations/authcallback/Zoho). Copy the Client ID and Client Secret that is displayed when you save the client - this will be needed in Mautic.

Screenshot of ZohoCRM developer server based application setup screen

Screenshot of creating the API credentials

  1. Insert the Client ID and Client Secret you created the Zoho Developers Console into the Mautic Zoho integration plugin, select the correct data centre based on the URL of your Zoho CRM instance, and click the button to authorize the plugin to access your instance. You will see a popup window which prompts you to log into Zoho and to authorize access - select Accept.

Note: You must select the correct data centre corresponding to your CRM instance - e.g. if you access your CRM at crm.zoho.com you should choose the .com option in the dropdown.

Screenshot of Zoho configuration screen in Mautic

Screenshot of authorization popup

Once you have authorized successfully, the button will update to show 'Reauthorize'.

  1. In the Features tab you can select the behaviour that you wish to have happen with this integration:
  • Triggered action push contacts to integration - when triggered, contacts are pushed from Mautic to Zoho
  • Pull contacts and/or companies from integration - pull all contacts and/or companies from ZohoCRM into Mautic
  • Push contacts and/or companies to this integration - push all contacts and/or companies from Mautic into ZohoCRM

Note this still requires a cron job to function.

You can also configure other options:

  • Update blank values: This will update blank values regardless of data priority, on both ZohoCRM and Mautic.
  • Choose what Zoho Objects to pull data from: Here you can specify which objects you want to pull from ZohoCRM - Leads, Contacts and/or Accounts

Screenshot of features available in ZohoCRM integration

  1. Configure the field mapping.

Note: If the values are empty for the Mautic object, a value of 'Unknown' will be sent. If the ZohoCRM field is a pick list, be sure the list values of Mautic's field match those of the field in ZohoCRM.

  1. Set the Publish switch to Yes.

  2. Save the plugin configuration.

Test the plugin

Follow these steps to test the integration.

Found errors? Think you can improve this documentation? edit this page