What is Version 4?

In order to accommodate multiple prospects with the same email address, we have created a new version of our APIs - version 4. If your Pardot org has this feature enabled now, then you must use version 4. If your Pardot org does not have this featured enabled, you must use version 3.

To determine if your Pardot org has this feature enabled, check out this guide.

For more information on the API in general, check out the Overview Page.

For specific API endpoints, please select from the "Version 4" list above.

Transitioning from version 3 to version 4

If you are going to upgrade your Pardot org to allow multiple prospects with the same email address, and you use the api, you will need to follow the guidelines below.

Request Path Changes

You will need to modify your request to use the /version/4 path. For example:

Before transition:

GET: https://pi.pardot.com/api/prospect/version/3/read/id/1

After transition:

GET: https://pi.pardot.com/api/prospect/version/4/read/id/1

Prospect API changes

Most of the changes in version 4 occur around the prospect APIs. When you begin using the version 4 APIs, your logic should know about these changes (full documentation can be found here)

Opportunity API changes

Full documentation can be found here.

Visitor API changes

Full documentation can be found here.