Looking for our API Documentation? Visit developer.pardot.comIn order for Pardot to send and receive data to and from Salesforce, Pardot must access the Salesforce API (application programming interface). This access of data is an API call. Note: If you have reached your API limit as a direct result of Pardot calls, please reach out to the Pardot Support Team to address this.
New Salesforce ConnectorWe've released a new Salesforce connector. It uses the OAuth protocol and changes how API calls from Pardot are accounted for in Salesforce. Once you've updated your Salesforce connector to the most recent version, there will be no impact on your Salesforce API limits when prospect records sync between Pardot and Salesforce. This article will walk you through updating to the new connector. A very small number of API calls will still count for things like viewing a lead or contact with a Pardot Activities section without being logged into Pardot (since we'll have to confirm your CRM username to display the activities), but most calls from Pardot will now be whitelisted.
Note on Reporting: The API Calls Made Within Last 7 Days report in Salesforce will still show API calls made by the connector. However, these API calls will not be included in the API Usage box of your System Overview in Salesforce — this shows API calls that count toward your Salesforce API limit.
What triggers an API call?API calls are made every time Pardot needs to send or receive data from Salesforce. The following actions cause API calls:
- Any update to a prospect record (user assignment, field updates)
- Prospect activities (Form and form handler submissions, landing page submissions, unsubscribing from emails)
- Prospect creation (manual creation, imports, creation in CRM (if option to automatically create in Pardot is turned on)
- Clicking Synchronize with CRM
- System actions (automation rules, completion actions, scoring changes, adding to Salesforce campaign, Salesforce campaign status changes)
- CRM actions (Updates and creations for contacts/leads/accounts/opportunities/campaigns/campaign members)
- Sending emails (if email logging is turned on at the Salesforce connector)
- Syncing of metadata (data that describes your objects, for example your contact fields) to Pardot
- Task creation
- Connector verification
Batch Syncs vs Single SyncsIf there is more than 1 record that needs to be synced, Pardot will sync in batches for efficiency's sake. The syncing of a batch will use the same number of API calls that a single record would use. For example, if there is 1 prospect to sync, 5-20 API calls are used. Similarly, if there are 600 prospects to sync, Pardot will batch them in groups of 200 and will only use 5-20 API calls total per batch.
What happens when my API limit is reached?If you reach API limit in Salesforce, Pardot (and any other connected applications that use API calls) will no longer be able to send and receive data to it. The Salesforce API limit is a 24 hour rolling limit. This limit is not per user, so all users on your instance will be affected. When the limit is reached, calls will be blocked until the usage for the preceding 24 hours drops below the limit.
Why is my API limit being reached?There are several reasons why you could be reaching your Salesforce API limit. The most common reason is using multiple web applications -- all of your applications share the API limit. Another common reason for high API usage is a high volume of updates to records. The more Pardot needs to sync with Salesforce, the higher the number of API calls. If there are a large number of records being imported into either system, or there are triggers and workflows that frequently use API calls, then you're more likely to reach the API limit. Finally, the email logging option on the Salesforce connector will use more API calls if turned on -- every time emails are synced, API calls are used.
How can I see my current API Usage?You can view your current API usage in Salesforce by navigating to Setup > Scroll down to Monitoring in left sidebar > System Overview. On the upper right hand side of the page, you will see a section entitled “API usage.” This will show you your number of API calls in the last 24 hours, your limit, and the percentage of your limit that has been used. You can also view your API usage in a standard Salesforce report. In Salesforce, navigate to Reports > Administrative Reports > API usage last 7 days. This report will show you the number of calls that have been made for each day over the last 7 days. You can also view the individual or application using the calls.
How can I decrease my API usage?There are several ways that you can lower your API usage:
Reducing updates/Timing updates
Constant updates to records will trigger syncing with Pardot and in turn use API calls. If there are workflows and triggers running in Salesforce that are not necessary, you may want to consider removing them. Also, the constant importing of records will result in increased API usage. If possible, limit importing to only those records that require creation or an update. In addition, you should consider running imports during times of lower activity so there is less competition for API calls.
The same number of API calls are used in batches and single record syncs. When possible, update records in batches as the number of API calls used is the same as individual syncs.
Turn off email logging
If you have turned on the feature to log emails on the connector, you may want to turn this feature off. Logging an email as an activity in Salesforce uses API calls, and depending on the volume of emails being sent, can quickly use up your API calls.