Skip to content

SmartCloud Connect and Salesforce API Calls Limit

SmartCloud Connect interacts with Salesforce by sending user-initiated as well as automatically generated requests to Salesforce servers via Salesforce API (API calls) and receiving their responses. There is a limitation on the number of incoming API calls Salesforce processes per 24 hours and to prevent this limit being reached by users having a vast amount of Salesforce objects in sync, SmartCloud Connect has a mechanism limiting the amount of Salesforce API calls it sends automatically on synchronization sessions.

If the internal SmartCloud Connect API calls limit is reached, you will get a throttling error notification ” Salesforce API calls minimal threshold exceeded ({actual %%} with limit of {limit %%}), synchronization will be retried later” on your sync dashboard; your current sync session will be terminated, and the following sessions’ sync interval will be progressively increased from 30 minutes to 2.5 – 4.5 – 6.5 – … hours until SmartCloud Connect determines that there are enough Salesforce API calls available; then the regular 30 minute synchronization cycle will be resumed automatically. The “minimal threshold exceeded …” error is triggered and SmartCloud Connect synchronization is semi-suspended well in advance before Salesforce API calls limit is about to be reached, so any other applications generating Salesforce API calls will continue running unaffected.

Important

Please note that you still can effectively use the SmartCloud Connect Add-In to work with Salesforce (e.g. search or create records) and share email messages (but not events) from your email client to Salesforce by saving emails in Salesforce manually from Read mode after synchronization has been suspended due to the daily API calls internal (SmartCloud Connect imposed) limit reached.
But if the overall (Salesforce imposed) API calls limit is reached, no interaction between the Add-In and Salesforce is possible.

In case you are working with a vast amount of Salesforce records daily, or use multiple integrations / customizations and start getting the throttling error, one way to prevent the daily API calls internal limit being reached is to increase your sync interval (by default it is set to one sync session every 30 minutes): less frequent synchronization sessions generate proportionally less API calls. Contact us by email at [email protected] to request that.

In addition, if the API calls limit is reached on Salesforce side, considering that the standard limit is sufficient for most SmartCloud Connect users, it is recommended that your local Salesforce admin check for other applications which also use Salesforce API: perhaps some of the apps which generate Salesforce API calls and are not actively used can be disabled. That would allot SmartCloud Connect synchronization more API calls. Salesforce offers a tool for managing API calls quotas for different apps that can be used to allocate API calls among SmartCloud Connect and other apps you are running.

Dependency Between Sync Scope / Records Updates Count and the Amount of API Calls Generated

When estimating the daily amount of Salesforce API calls sent by SmartCloud Connect you can take into consideration the following factors:

  • A daily amount of up to 1,500 Salesforce API calls (10% of the standard limit in Salesforce) is generated daily to maintain synchronization and is not involved in conveying Salesforce records modifications, being idle sync API calls. This amount will be practically the same regardless of the overall amount of records in Salesforce (synchronization scope).
  • The scope of records updates carried out on sync sessions may significantly affect the amount of Salesforce API calls sent. Depending on the nature of a record update (e.g. updating several fields of a single record vs. modifying series of recurring events), it may require from 1 to 10 API calls per modification. For your estimates you can assume that on average 3% of all records in Salesforce get updated per 24 hours, and this requires a certain additional amount of API calls to be sent.

Important

please note that when you are using SmartCloud Connect there should be no other software running that performs data transfer between MS Exchange and Salesforce API (e.g. Salesforce Inbox, Salesforce for Outlook, etc.) Running different MS Exchange – Salesforce sync applications simultaneously will cause sync conflicts and items duplication. If you encounter this kind of unexpected behavior, please check that with your Salesforce admin or, if you are a Salesforce damin, check for such software in the following places:

Note that apps which use Salesforce API but do not exchange data between Salesforce and MS Exchange will not cause sync conflicts.