Pardot APIs let you extend your marketing automation efforts with integrations. Postman is an API platform that makes it easy to build, test, and experiment with API calls. You can use Pardot and Postman together to easily test and explore all that v5 of the Pardot API has to offer.

On the Postman platform, a Postman Collection is a group of requests that are saved and organized in folders. Our collection includes calls for the 15 objects in v5 of the Pardot API.

This blog post focuses on the Pardot public collection, so if you’re not already using Postman with the Salesforce API, check out the blog post, Explore the Salesforce APIs with a Postman Collection, to learn more. If you’ve never used an API client and you’re feeling overwhelmed, check out the Postman API Client Trailhead module to get some hands-on experience and gain confidence.

Just a quick note before you get started: this collection is provided as-is. It’s not officially supported by Salesforce or covered by SLAs.

Getting started with Postman

Before you get started, you need a Salesforce username and password, a Pardot Business Unit ID, and the Consumer ID and Consumer Secret for a connected app with the Access Pardot Services scope. For more help, see the Getting Started with Pardot APIs guide in the Pardot developer docs.

Next, install Postman and import the Pardot collection by following the instructions in our Github project.

Finally, you are ready to set up authorization; the collection’s authorization uses variables with OAuth 2.0.

On the collection folder’s tab, click Variables and add your information to the Current Value column. Note: grant_type, sf_username, and sf_password are only required if you choose to use the the username/password OAuth2.0 flow.

An image of the Variables tab with three columns: Variable, Initial Value, and Current Value

After you’ve set up your variables, click the Authorization tab, scroll to the bottom, and click Get New Access Token. Follow the prompts to authorize.

We’ve added robust documentation to the collection to make sure that you can find what you need. So, anytime you get stuck, just open the Documentation pane to get unstuck.

An image of the Documentation pane opened in Postman

Making a request to the Pardot API

After you’ve authorized, start experimenting with making requests to the Pardot API. For this example, let’s query the Campaigns object.

Open the Campaign folder, then click Query.

An image of the Postman Collection folder structure with the Query request highlighted in the Campaign folder

Configure the parameters for your query and click Send.

Alt text: An image of the parameters for the call

If the request is successful, you’ll see a response on the bottom half of the page.

An image of a JSON response

Conclusion

Now that you’ve seen the basics, get out there and start using Postman to make working with the Pardot API easier than ever. Also, make sure you check out the Pardot developer docs to get the most out of working with Pardot.

About the author

Casey Smith is a Staff Technical Writer at Salesforce.

Get the latest Salesforce Developer blog posts and podcast episodes via Slack or RSS.

Add to Slack Subscribe to RSS