Resolve Salesforce integration suspension errors

The HubSpot-Salesforce integration may be suspended due to a number of reasons. You can choose to receive email notifications whenever your HubSpot-Salesforce integration gets 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 allocation 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 user profile administrative permission, then re-enter the 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. However, if the error persists after clicking Clear Suspension, contact HubSpot Support.

Salesforce Object Permissions Missing

The two most common causes of this error are:

• The integration user doesn't have the HubSpot Integration Permission set (in the Available Permission Sets section) in Salesforce.
• One of the objects trying to sync doesn't have the correct permissions in Salesforce.

• Ensure that the integration user has Read and Edit permissions for the object trying to sync.
• If the integration user has Read and Edit permissions, the error may involve a cross-related object. Ensure that the integration user has Read and Edit permissions on all related (such as by lookup) objects. The integration typically requires access to the following objects: 
  • Leads
  • Contacts
  • Accounts
  • Opportunities
  • Campaigns
  • Tasks
  • Users

Salesforce Field Permissions Missing

The integration user doesn't have Read and Edit permissions for a field on the syncing object, or for a field on a related object by lookup.

Salesforce Organization Locked

A temporary error occurs when an action must be completed before another update can take place. For example, another integration may be updating an object at the same time HubSpot is also updating it. If the error persists after clicking 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 clicking Clear Suspension, check Salesforce Status or contact Salesforce support.

HubSpot API Limit Exceeded

The API call allocation set in HubSpot is exceeded. Check your Salesforce API call allocation and increase the API call limit in HubSpot accordingly. Once there are more API calls available, the suspension will be cleared automatically.

The API usage shown in the Salesforce sync screen is based on a rolling 24-hour window. The API limit applies to the most recent 24-hour period.

Missing Field Mappings

There are no mappings between HubSpot properties and Salesforce fields. If the error persists after clicking Clear Suspension, or there are no standard field mappings in your integration settings, contact HubSpot support.