Skip to content

Resolve Salesforce integration suspension errors

Last updated: June 28, 2023

Available with any of the following subscriptions, except where noted:

Marketing Hub Professional, Enterprise
Sales Hub Professional, Enterprise
Service Hub Professional, Enterprise
Operations Hub Professional, Enterprise
CMS 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 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, 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 doesn't have the HubSpot Integration Permission set (in the Available Permission Sets section, select HubSpot Integration Permissions) 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 and Edit permissions on the object.
  • If the user has Read and Edit permissions, it is a cross-related object. Ensure that the integration user has Read and Edit permissions on any related (such as by lookup) objects. 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 and Edit 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 allocation set in HubSpot is exceeded. Check your Salesforce API call allocation and increase the API call limit in HubSpot accordingly. Once there are additional API calls available, the suspension will be cleared automatically.

The API call use displayed in the Salesforce sync screen is a sliding window/rolling 24 hour period. The API limit applies to the most recent 24 hours period.

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.

Was this article helpful?
This form is used for documentation feedback only. Learn how to get help with HubSpot.