Salesforce

How do I fix an error displayed on the Salesforce Sync Error screen?

Last updated: March 21, 2017

Available For:

Marketing: Pro, Enterprise
Sales: Professional

Take a look below at the common causes of Salesforce Sync Errors and how you can fix them inside your HubSpot account.

Converted Lead

This contact has been converted from a Lead to a Contact in Salesforce. Since you have selected to automatically add Leads created in Salesforce but not Contacts to HubSpot, we can no longer sync with this contact. To change this:

  • Navigate to your Account Menu > Integrations.
  • Select Settings within the Salesforce section.
  • Check off the Create a HubSpot contact when a contact is created in Salesforce check-box under Records Created in Salesforce > click Save at the bottom of the page.

Once you have checked the contacts box, contacts will sync successfully again the next time they are changed in HubSpot or Salesforce.


Merged in Salesforce

When a contact is merged into another contact in Salesforce, but still exists in HubSpot, this error will occur. The error is harmless in that it doesn’t prevent any data from syncing, but is a good indication that HubSpot and Salesforce might become out of sync over time. If you’d like to prevent this, it is a good idea to turn on the Delete the contact in HubSpot when a Salesforce lead/contact is deleted functionality, which will delete a HubSpot contact when it’s corresponding lead/contact in Salesforce is deleted or merged. You can turn this feature on in HubSpot by navigating to:

  • Account Menu > Integrations > select Settings within the Salesforce section > scroll down to Delete in HubSpot when deleted in Salesforce.
  • Select the checkboxes to delete a HubSpot contact when a lead/contact is deleted in Salesforce > click Save at the bottom of the page.


SOQL Queries Limit Exceeded

SOQL queries use the Salesforce Object Query Language (SOQL) to search for data that meet certain conditions in Salesforce. Each Salesforce org is provisioned a certain number of concurrent and total number of SOQL queries per day. Encountering this error will cause some contacts not to sync.

This error is most commonly associated with 3rd party packages installed into you Salesforce org, which can sometimes conflict with HubSpot. For example, if you have a package that de-duplicates records in Salesforce, it may be at odds with HubSpot. Please try uninstalling the 3rd party package and seeing if the error persists. If you still see the error, please generate a debug log in Salesforce by going to:

  • *Your Name* > Set up > Monitoring > Debug Logs or Logs > Debug Logs and then reach out to HubSpot Support.


Code Statement Limit Exceeded

Salesforce packages run code on a Salesforce org to retrieve certain information. Each Salesforce org is provisioned a certain number of concurrent and total number of code statements a day. Encountering this error will cause some contacts not to sync until the error is resolved.

This error is most commonly associated with 3rd party packages installed into you Salesforce org, which can sometimes conflict with HubSpot. For example, if you have a package that de-duplicates records in Salesforce, it may be at odds with HubSpot. Please try uninstalling the 3rd party package and seeing if the error persists. If you still see the error, please generate a debug log in Salesforce by going to:

  • *Your Name* > Set up > Monitoring > Debug Logs or Logs > Debug Logs and then reach out to HubSpot Support.


Salesforce Save Error

When HubSpot is unable to save data to Salesforce, this error occurs. Next to your Salesforce save error, you will see data from Salseforce that indicates what caused the save error. For example, we might be unable to save a contact to Salesforce because of an invalid email address.


Deleted in Salesforce

When a lead/contact is deleted in Salesforce, but still exists in HubSpot, this error will occur. The error is harmless in that it doesn’t prevent any data from syncing, but is a good indication that HubSpot and Salesforce might become out of sync over time. If you’d like to prevent this, it is a good idea to turn on the Delete the contact in HubSpot when a Salesforce lead/contact is deleted functionality, which will delete a HubSpot contact when it’s corresponding lead/contact in Salesforce is deleted or merged. You can turn this feature on in HubSpot by navigating to:

  • Account Menu > Integrations > select Settings within the Salesforce section > scroll down to Delete in HubSpot when deleted in Salesforce.
  • Select the check-boxes to delete a HubSpot contact when a lead/contact is deleted in Salesforce > click Save at the bottom of the page.


Edited During Sync

This occurs when when a user in Salesforce is editing a contact at the same time HubSpot is trying to sync with it. HubSpot will successfully sync with the contact the next time that a sync is triggered on it. If you'd like a contact to sync immediately, click on the Resync with Salesforce button on a contact record.


Validation Error

Validation errors occur when a contact from HubSpot doesn't meet the requirements for a validation rule that is set on a lead, contact, or account record in Salesforce. Some examples might be "Lead must have a company" or "Account must have a zip code." In many cases, this validation rule is set up without fully realizing the implication it has on the HubSpot integration with Salesforce. If a contact can't sync to Salesforce because of a validation rule, the sync for that contact will fail indefinitely. To fix this simple remove (or have your Salesforce Admin) remove the validation rule.


Non-Unique Options

This occurs when a Salesforce field with options associated with it (usually a picklist) have two options that are the same. HubSpot does not know which Salesforce option to sync the value in HubSpot with, so the sync will fail. To fix this, log into Salesforce, go to [Your Name] > Setup then find the field and delete one of the duplicate options. Once you do, the contacts will successfully sync next time a value on the contact changes. If you’d like to resync the contacts immediately, make a list of those contacts and click the Resync with Salesforce button on the list of contacts.


Data Type Mismatch

When a HubSpot property and a Salesforce field are mapped together but have some different data types (i.e. the HubSpot property is a Dropdown type and the Salesforce field is a Currency type), data between the two may not sync. To fix this, you will need to change the type of one of the fields to more closely mirror the field that it is mapped to (in the example above, changing the Salesforce field to a picklist would resolve the issue). Your systems will soon be in sync once the changes are successfully made.


Other

This is an issue that HubSpot is unable to identify. If these issues represent a small fraction of your total syncs, please wait before calling support, as they in many cases resolve themselves. If the issue persists, please contact support.

Was this article helpful?