{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-user-guide/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"redocly_category":"User Guide","type":"markdown"},"seo":{"title":"Zoho CRM common errors","description":"Access documentation, use cases, and technical guides for Lusha. Learn how to query our comprehensive dataset of business profiles and company information using our three main endpoints.","siteUrl":"https://docs.lusha.com","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"zoho-crm-common-errors","__idx":0},"children":["Zoho CRM common errors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When exporting contacts from Lusha to Zoho CRM, you may encounter errors related to authorisation, field mapping, or how contact data is structured. This article covers the most common errors and how to fix each one."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{"className":"callout-note"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["💡 Note: Most integration issues can only be resolved by a Zoho CRM Administrator and a Lusha Admin. In many cases, this is the same person."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"export-fails-or-integration-stops-working","__idx":1},"children":["Export fails or integration stops working"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If contacts that previously exported successfully are now failing, or the export button produces no result, the most common cause is an expired or dropped connection between Lusha and Zoho CRM."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To fix this:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://dashboard.lusha.com/lusha-integrations"},"children":["Integrations"]}," in your Lusha dashboard."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Disconnect the Zoho CRM integration."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Reconnect and complete the OAuth authorisation flow again."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Retry the export."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the issue started suddenly with no changes on your side, it may be a temporary service disruption. Wait a few minutes, reconnect, and try again."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"unable-to-connect-lusha-and-zoho-crm-insufficient-permissions","__idx":2},"children":["Unable to connect Lusha and Zoho CRM (insufficient permissions)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you see an error during the connection flow, or users report they cannot export contacts even though the integration appears connected, the most likely cause is that the user completing the OAuth did not have Zoho CRM Administrator privileges at the time of connection."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To fix this:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Have a Zoho CRM Administrator disconnect the integration in Lusha."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Log into Zoho CRM as that Administrator."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Reconnect the integration from Lusha's ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://dashboard.lusha.com/lusha-integrations"},"children":["Integrations page"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Complete the OAuth flow while logged in as the Administrator."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If individual users on your team are getting permission errors while trying to export, check that their Zoho CRM role includes write access to Leads or Contacts (whichever record type you are exporting to). Refer to ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/user-guide/integrations-basics/crm-permissions-required-for-lusha-integration"},"children":["Lusha's CRM permissions guide"]}," for the minimum required permissions."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"contact-is-exported-to-the-wrong-record-type-contact-vs-lead","__idx":3},"children":["Contact is exported to the wrong record type (Contact vs Lead)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["By default, Lusha exports contacts to Zoho CRM as ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Leads"]},". If contacts are appearing as ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Contacts"]}," (or vice versa), this is likely a field mapping configuration issue."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To change the target record type:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings → Integrations → Zoho CRM → Field Mapping"]}," in Lusha."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm that the object type (Lead or Contact) matches your intended Zoho module."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Save and retry the export."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you need contacts exported to a specific pipeline or view within Zoho, configure this in your Zoho CRM lead assignment rules after import — Lusha does not control post-import routing."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"account-name-is-missing-after-export","__idx":4},"children":["Account name is missing after export"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When a contact is pushed to Zoho CRM, the associated company (account) name may not appear on the record, even if it was visible in Lusha."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This usually means the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Company"]}," field is not mapped in your Lusha field mapping configuration."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To fix this:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Settings → Integrations → Zoho CRM → Field Mapping"]}," in Lusha."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Map the Lusha ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Company"]}," field to the Zoho ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Account Name"]}," (for Contacts) or ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Company"]}," (for Leads) field."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Save the mapping and retry the export."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Note: Zoho CRM does not automatically create an Account record from the Company name field on a Lead. If you need full account linkage, you will need to convert the Lead to a Contact in Zoho and associate it with an Account record manually."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"compound-or-middle-names-are-not-exported-correctly","__idx":5},"children":["Compound or middle names are not exported correctly"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If a contact has a compound first name or a middle name (for example, \"Juan Bautista Bajo\"), Lusha parses names into two structured fields:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["First Name"]}," → the first given name only (\"Juan\")"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Last Name"]}," → the final surname only (\"Bajo\")"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The middle part of a compound name (\"Bautista\" in this example) is treated as a middle name and is not pushed to Zoho's First Name or Last Name fields, because Zoho CRM does not have a standard Middle Name field on Lead or Contact records."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Workaround:"]}," Map the Lusha ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Full Name"]}," field to a custom Zoho CRM text field that you create for this purpose. This preserves the complete name as a single string. Note that Lusha does not support field concatenation — you cannot combine First Name + Middle Name into a single target field."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"lusha-sidebar-not-appearing-in-zoho-crm","__idx":6},"children":["Lusha sidebar not appearing in Zoho CRM"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the Lusha panel is not visible when viewing a Lead or Contact record in Zoho CRM:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Open the Lusha browser extension and click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["More"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Make sure ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Enable Lusha Everywhere"]}," is toggled on. If it is already on, toggle it off, then back on, and restart your browser."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If the issue persists, open your browser's developer tools, right-click the refresh button, and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Empty Cache and Hard Reload"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm you are using a supported browser (Chrome or Edge) and that the Lusha extension is up to date."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"export-succeeds-but-crm-indicator-is-not-showing-existing-contacts","__idx":7},"children":["Export succeeds but CRM indicator is not showing existing contacts"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The \"already in CRM\" indicator in Lusha identifies contacts that are already in your connected Zoho CRM. If this indicator is not appearing for contacts you know are in Zoho:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm the integration is connected under ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://dashboard.lusha.com/lusha-integrations"},"children":["Integrations"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The indicator relies on email address matching between Lusha's data and your Zoho records. If a contact's email in Zoho differs from the one Lusha has, no match will be found."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Allow a few minutes after reconnecting for the sync to update."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If none of the above resolves your issue, contact Lusha Support using the chat icon in your dashboard or email ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"mailto:support@lusha.com"},"children":["support@lusha.com"]},"."]}]},"headings":[{"value":"Zoho CRM common errors","id":"zoho-crm-common-errors","depth":1},{"value":"Export fails or integration stops working","id":"export-fails-or-integration-stops-working","depth":2},{"value":"Unable to connect Lusha and Zoho CRM (insufficient permissions)","id":"unable-to-connect-lusha-and-zoho-crm-insufficient-permissions","depth":2},{"value":"Contact is exported to the wrong record type (Contact vs Lead)","id":"contact-is-exported-to-the-wrong-record-type-contact-vs-lead","depth":2},{"value":"Account name is missing after export","id":"account-name-is-missing-after-export","depth":2},{"value":"Compound or middle names are not exported correctly","id":"compound-or-middle-names-are-not-exported-correctly","depth":2},{"value":"Lusha sidebar not appearing in Zoho CRM","id":"lusha-sidebar-not-appearing-in-zoho-crm","depth":2},{"value":"Export succeeds but CRM indicator is not showing existing contacts","id":"export-succeeds-but-crm-indicator-is-not-showing-existing-contacts","depth":2}],"frontmatter":{"title":"Zoho CRM common errors","description":"How to diagnose and fix the most common Zoho CRM integration errors in Lusha, including export failures, field mapping issues, permissions, and name parsing.","seo":{"title":"Zoho CRM common errors"}},"lastModified":"2026-07-15T07:33:23.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/user-guide/zoho/zoho-common-errors","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}