Salesforce

Resolve Salesforce integration suspension errors

Last updated: January 7, 2019

Applies to:

Marketing Hub Professional, Enterprise
Sales Hub Professional, Enterprise
Service Hub Professional, Enterprise
The HubSpot-Salesforce integration may be suspended due to a number of reasons. You can choose to receive email notifications when your HubSpot-Salesforce integration is suspended.
  • Salesforce Organization API Limit Exceeded: the API call limit in your Salesforce organization is exceeded. It's recommended that you set your Salesforce API call limit in HubSpot to prevent exceeding your Salesforce API call limit. If you're doing a migration, you can contact Salesforce support and request a temporary increase in your API call limit.
  • Salesforce Organization API Access Disabled: ensure that the integration user has the API Enabled permission in Salesforce, then re-enter your Salesforce user credentials to clear the suspension message.
  • Unknown Error: the error sent from Salesforce isn't clear or known. These types of suspensions are rare and often resolve themselves, but if the error persists after you click Clear Suspension, contact HubSpot support.
  • Salesforce Object Permissions Missing: the two most common causes of this error is that the integration user does not have the HubSpot Integration permission set in Salesforce, or one of the objects attempting to sync doesn't have the correct permissions in Salesforce.
    • Ensure that the integration user has Read/Write permissions on this object.
    • If the user has Read/Write permissions, it is a cross-related object. Ensure that the integration user has Read/Write permissions on any related objects, such as by lookup. The objects typically required by the integration are:
      • Leads
      • Contacts
      • Accounts
      • Opportunities
      • Campaigns
      • Tasks
      • Users
  • Salesforce Field Permissions Missing: the integration user doesn't have Read/Write permissions for a field on the syncing object, or a field on an object related by lookup.
  • Salesforce Organization Locked: a temporary error caused when an operation is occurring that must be completed before another update can occur. For example, another integration is making an update to an object that is simultaneously being updated by HubSpot. If the error persists after you click Clear Suspension, contact your Salesforce system administrator to unlock the organization.
  • Salesforce Organization Storage Limits Exceeded: the storage limit in your Salesforce organization is exceeded. Learn how to delete HubSpot records in bulk from Salesforce.
  • Salesforce Organization Unavailable: Salesforce is currently experiencing outages. Check Salesforce Status for updates on service availability and performance.
  • Salesforce.com Server Error: Salesforce returned an unknown error. If the error persists after you click Clear Suspension, check Salesforce Status or contact Salesforce support.
  • HubSpot API Limit Exceeded: the API call limit set in HubSpot is exceeded. Check your Salesforce API call limit and increase the API call limit in HubSpot accordingly. Once there are additional API calls available, the suspension will be cleared automatically.
  • Missing Field Mappings: there are no mappings between HubSpot properties and Salesforce fields. If the error persists after you click Clear Suspension, or there are are no standard field mappings in your integration settings, contact HubSpot support.