Setting your Salesforce API request threshold 

Keepit uses Salesforce APIs to back up and restore Salesforce data. The number of API requests available depends on your Salesforce edition, the number of Salesforce licenses, and whether any additional API licenses have been purchased. 

Keepit allows you to set a threshold as a percentage of your total API request limit to help you manage usage and avoid exceeding the limits.  

Backup process

When the connected applications, including Keepit, reach the configured threshold, any ongoing backups or restores will pause.  

In case of a backup, a partial snapshot is created, and the backup will resume from where it paused once new API calls become available (midnight Pacific Time). Note that data in partial snapshots is available to you in the Keepit application. 

Default threshold 

The default threshold is set to 50%. This ensures that 50% of the total number of your available API requests remain reserved for (unexpected) critical operations in your applications. If you notice a high number of partial backups and don’t need 50% available for critical usage, you may want to increase the threshold

Initial backup

The initial backup is a full backup and requires more API requests than subsequent incremental backups. We recommend setting the threshold higher for the initial backup and pausing any non-critical applications that are using API requests. This helps prevent bottlenecks and ensures your Salesforce data is secured more quickly. 

Once the initial backup is completed, set the percentage back to a level that preserves enough API requests for (unexpected) critical operations while still allowing room for efficient incremental backups. 

Bi-monthly backup

Every 30th backup, we perform a full scan of your entire Salesforce database to ensure that no items were missed in the daily backups. Due to the volume of data scanned, these backups can take longer than usual and consume more API requests. 

For more info, see: How to speed up Salesforce monthly backups

Restore process

If a restore fails because the limit was reached, you can try increasing your Salesforce API request and then restoring again. Once complete, decrease the limit again to your preferred usage. 

Creating a new connector

If you have reached your Salesforce API request limit, you won't be able to create a new connector. Please try again after new API calls become available (midnight Pacific Time).

Adjusting your Salesforce API request threshold in Keepit

To modify the API request threshold:

1. Open the Salesforce connector configuration window.

2. Use the slider to set your preferred API usage percentage.

Remember, the selected percentage reflects total API usage across all applications.

For instance, if you set the threshold to 80%, Keepit will pause backups once 20% of your total Salesforce API requests remain.

All changes made to the API limit are recorded in the audit log.

Increase your API limit in Salesforce

If your default API limit in Salesforce is insufficient for your business requirements, you can request a temporary or permanent increase to the limit. For instructions on how to do this, refer to Salesforce's documentation: Increase your organization's API limit