Creating a Custom OAuth Application

If you do not have access to the user name and password or do not wish to require them, you can use OAuth authentication. Salesforce Marketing Cloud Account Engagement uses the OAuth authentication standard, which requires the authenticating user to interact with Salesforce Marketing Cloud Account Engagement via the browser. The driver facilitates the OAuth exchange in various ways, as described in this section.

Create an OAuth Application

To obtain the OAuth client credentials, consumer key, and consumer secret:

1. Log in to salesforce.com.
2. From Setup, enter Apps in the Quick Find box and then click the link to create an application. In the Connected Apps section of the resulting page, click New.
3. Enter a name to be displayed to users when they log in to grant permissions to your application, along with a contact Email address.
4. Click Enable OAuth Settings and enter a value in the Callback URL box. If you are creating a desktop application, set the Callback URL to http://localhost:33333 or to a different port number of your choice. If you are creating a web application, set the Callback URL to a page on your web application you want the user to be returned to after they have authorized your application.
5. Select the scope of permissions that your application should request from the user. At a minimum, OAuth scopes must include "pardot_api", "api", and "refresh_token" scopes. Adding "refresh_token" causes the API to returen a refresh token in the OAuth request, which the driver then uses to automatically refresh the access token when it expires.

   Use "full" to include all scopes. Otherwise, only the username-password OAuth flow can be used with the Pardot API.

6. Click your application name to open a page with information about your application. The OAuth client credentials, consumer key, and consumer secret are displayed.

Create an OAuthJWT Application

1. Log in to salesforce.com.
2. From Setup, enter Apps in the Quick Find field and then click the link to create an application. In the Connected Apps section of the resulting page, click New.
3. Enter a name to be displayed to users when they log in to grant permissions to your application, along with a contact Email address.
4. Click Enable OAuth Settings and enter a value in the Callback URL box. Set this value only to create the Connected application. It is not needed for this type of authentication. The Callback URL is in the format:
   

   http://localhost:8019/src/oauthCallback.rst

5. Enable Use digital signatures.
6. Upload your certificate.
7. Select the scope of permissions that your applicationshould request from the user. At a minium, the selected OAuth scopes must include'"pardot_api" and "api" scopes. Select "full" to include all scopes.
8. Click your application name to open a page with information about your application. The OAuth consumer key is displayed.