Salesforce

Items affected by Salesforce sync error not automatically resyncing

Last updated: July 10, 2018

Applies to:

Marketing Hub
marketing-pro-enterprise
Professional, Enterprise
Sales Hub
sales-pro-enterprise
Professional, Enterprise

If a HubSpot object attempts to sync to Salesforce and fails, the failure will be indicated by a warning message in the Salesforce Sync card on the object record. Learn how to identify and resolve Salesforce integration sync errors.


HubSpot will automatically try to resync all items with sync errors every 20 minutes up to ten times. Once an item has errored ten times, it is placed in a "timeout queue" and retried with all other errored items in the queue once a day at midnight GMT.

Items with sync errors can also be resynced manually in two ways:

  1. Individual item: Click Resync in the Salesforce Sync card on the object record.
  2. In bulk by error: In your HubSpot account, click your account name in the top right corner, then click Integrations. Locate the Salesforce integration, then click the More dropdown menu and select View settings. Click the Sync errors tab. Hover over an error and click Resync to attempt resyncing the items affected by the error.

As retrying syncs may use significant API calls and Salesforce data storage (HubSpot Logs/Log Messages), syncs will not retry if one of three conditions are met:

  1. There is no HubSpot API call limit and HubSpot has used more than 5,000 API calls in the past 24 hours.
  2. HubSpot has used more than 75% of the HubSpot API call limit.
  3. HubSpot has attempted to sync the record ten times and received an error each time.

HubSpot will not allow errored syncs to retry once one of these thresholds has been met in order to preserve the remaining API calls for new syncs that may occur. You can choose to wait for the API call limit to reset, or raise the HubSpot API call limit.

In your HubSpot account, click your account name in the top right corner, then click Integrations. Locate the Salesforce integration, then click the More dropdown menu and select View settings. In the API Call Use (past 24 hours) section, you can raise the API call limit in the Allocated to HubSpot field.

Once you've resolved the sync errors, you can delete the corresponding HubSpot Logs from Salesforce to decrease data storage usage.