Pardot Authenticate an Element

Authentication Prerequisites

The Pardot element uses the three different types of authentication workflows - oauth2, oauth2password and jwtOauth.

Before you can authenticate an instance of the Pardot element, you would primarily require:

  1. Salesforce Single Sign On (SSO)
  2. Pardot Business Units enabled

All the three authentication methods are discussed in more detail below. For detailed information on how to authenticate an instance, see our related documentation:

Oauth2

To authenticate via oauth 2, you will require the Oauth Key and Oauth Secret. Follow the steps provided in the article Pardot API Provider Setup to first enable the Salesforce SSO and then generate your Oauth credentials.

Required Authentication Parameters

To authenticate an instance of the Pardot element using Oauth2, you will need the following parameters:

Parameter Name/UI ValueAPI Value/KeyDescriptionSource
Authentication typeauthentication.typeThe method using which you want to authenticate.Select Authentication type as the authentication method.
Connect to Sandboxpardot.sandboxBoolean field for pardot sandbox. If set to true, user needs to mention which of the two sandboxes provided by Pardot they would like to use.Pardot.
OAuth API Keyoauth.api.keyThe OAuth API Key.Pardot API Provider Setup
OAuth2 Business Unit Idoauth.business.unit.idThe OAuth2 Business Unit Id.Pardot API Provider Setup
OAuth API secretoauth.api.secretThe Oauth API secret.Pardot API Provider Setup

Sample Configuration JSON

"configuration": {
    "provider.version": "3",
    "filter.response.nulls": "true",
    "base.url": "https://login.salesforce.com",
    "pardot.sandbox": "false",
    "synchronous.bulk.notification": "true",
    "authentication.type": "oauth2",
    "oauth.api.key": "<my_api_key>",
    "oauth.business.unit.id": "xxxxxxxxxxxx",
    "oauth.api.secret": "******"
  }

Oauth2Password

The Oauth2Password method is a kind of oauth2 authentication. To authenticate via oauth2password, you will require the Oauth2 Password API Key and Oauth2 Password API Secret. Follow the steps provided in the article Pardot API Provider Setup to first enable the Salesforce SSO and then generate your Oauth2Password credentials.

Required Authentication Parameters

To authenticate an instance of the Pardot element using Oauth2Password, you will need the following parameters:

Parameter Name/UI ValueAPI Value/KeyDescriptionSource
Authentication typeauthentication.typeThe method using which you want to authenticate.Select Authentication type as the authentication method.
Connect to Sandboxpardot.sandboxBoolean field for pardot sandbox. If set to true, user needs to mention which of the two sandboxes provided by Pardot they would like to use.Pardot.
OAuth2 Password API Keyoauth2password.api.keyThe OAuth2 Password API Key.Pardot API Provider Setup.
OAuth2 Password Business Unit Idoauth2password.business.unit.idThe OAuth2 Password Business Unit Id.Pardot API Provider Setup.
OAuth 2 Password API secretoauth2password.api.secretThe Oauth2 Password API secret.Pardot API Provider Setup.
Usernamesfdc.usernameSFDC Username.Pardot.
Passwordsfdc.passwordSFDC Password.Pardot.

Sample Configuration JSON

"configuration": {
    "provider.version": "3",
    "filter.response.nulls": "true",
    "base.url": "https://login.salesforce.com",
    "pardot.sandbox": "false",
    "synchronous.bulk.notification": "true",
    "authentication.type": "oauth2Password",
    "oauth2password.api.key": "<my_api_key>",
    "oauth2password.api.secret": "******",
    "oauth2password.business.unit.id": "xxxxxxxx",
    "sfdc.username": "<my_sfdc_username>",
    "sfdc.password": "******"
  }

JWTOauth

Required Authentication Parameters

To authenticate an instance of the Pardot element using jwtOauth, you will need the following parameters:

Parameter Name/UI ValueAPI Value/KeyDescriptionSource
Authentication typeauthentication.typeThe method using which you want to authenticate.Select Authentication type as the authentication method.
Connect to Sandboxpardot.sandboxBoolean field for pardot sandbox. If set to true, user needs to mention which of the two sandboxes provided by Pardot they would like to use.Pardot.
JWTOAuth API Keyjwtoauth.api.keyThe OAuth API Key.Pardot API Provider Setup.
JWTOAuth Business Unit Idjwtoauth.business.unit.idThe OAuth2 Business Unit Id.Pardot API Provider Setup.
JWTOAuth API secretjwtoauth.api.secretThe Oauth API secret.Pardot API Provider Setup.
JWT Base64 Encoded Keyjwt.base64.encoded.keyJWT Base64 Encoded Key.Pardot.
Audiencejwt.claim.audThe SFDC audience.Pardot.
Issuerjwt.claim.issJWT Issuer - the issuer of the JWT Base64 encoded key.Pardot.
Subjectjwt.claim.subJWT Subject - the sfdc account user name.Pardot.

Sample Configuration JSON

"configuration": {
    "provider.version": "3",
    "filter.response.nulls": "true",
    "base.url": "https://login.salesforce.com",
    "pardot.sandbox": "false",
    "synchronous.bulk.notification": "true",
    "authentication.type": "jwtOauth",
    "jwtoauth.api.key": "<jwt_api_key>",
    "jwtoauth.api.secret": "******",
    "jwtoauth.business.unit.id": "xxxxxxxx",
    "jwt.base64.encoded.key": "xxxxxx",
    "jwt.claim.aud": "xxxxxx",
    "jwt.claim.iss": "xxxxxxx",
    "jwt.claim.sub": "xxxxxxx"
  }

Optional Authentication Parameters

These are the optional parameters you will need, to authenticate an element instance via any of the methods discussed above.

Parameter NameAPI ValueDescription
Base URLbase.urlhttps://login.salesforce.com
Pardot API Versionprovider.versionSet this to the version of Pardot you have enabled in the account. For example, you can set this to 4, if you have version 4 enabled in your account.
Instance Variablesinstance.variablesStates what the instance variables are.
Callback Notification Signature Keyevent.notification.signature.keyA key used to generate a validation hash header of the event/bulk notification callback payload.
Synchronous Bulk Notificationsynchronous.bulk.notificationEnables synchronous bulk callback notification.
Filter Null Values from Responsefilter.response.nullsUsed to enable/disable filtering of null values from the responses.

Element Fact Sheet and Reference

Authentication and Configuration Parameters

To see all authentication parameters for the Pardot element, follow these steps:

  1. Sign in to Cloud Elements and navigate to Elements.
  2. Hover over the card for an element, and then click My Resources. 
  3. In the top navigation toolbar, click Setup.
  4. From the 'Setup' page, you can view a complete list of the element's authentication and configuration parameters.