Intercom’s Salesforce app lets you easily understand and manage your API usage with an enforced limit that you define. 👌

Understand your usage

In the Salesforce app’s settings, under “Manage Salesforce API usage” you’ll see this simple indicator which shows you:

  • Your total Salesforce API limit over a 24 hour period (15,000 in this example).

  • How much of that limit has been used by the current Intercom workspace (2,495 in this example).

  • How much has been used by other integrations or Intercom workspaces connected to your Salesforce organization (863 in this example).

Note: This chart is updated every time you load the app settings.

Set a limit for Intercom

Here you can also define the maximum number of calls this Intercom workspace can make to the Salesforce API in 24 hours:

What happens when you reach the limit?

There are 2 situations:

  • When you reach 80% of your defined limit, you’ll see the following warning in the Salesforce app settings:
    This workspace will soon hit its limit of Salesforce API calls. This will pause your data sync with Salesforce. Increase the limit in the settings below to avoid this”.

  • Once you reach the limit, you’ll see this warning:
    This workspace has hit its limit of Salesforce API calls. Your data sync with Salesforce is paused and the integration won’t work as expected. Increase the limit in the settings below to avoid this.”

In both cases, we recommend you increase the limit assigned to Intercom.

Certain parts of the app’s functionality are impacted differently by the limit:

  • App settings — This bypasses your defined Intercom API limit and will always be available to load and modify (within your total Salesforce API limit).

  • Inbox app — The Inbox app will continue to load updated information from Salesforce as long as you’re within the defined Intercom API limit.

  • Periodic sync — Background updates to your Salesforce and Intercom data (when there are changes or new records in either place) will be paused when you reach 60% of the defined Intercom API limit. This ensures the Inbox app will continue to load for as long as possible within the defined limit.

Did this answer your question?