Skip to main content

​
Authenticate to Salesforce Marketing Cloud Account Engagement

After you add the connector, you need to set the required properties. Business Unit ID: Enter your business-unit identifier (Id). This Id is required when you use an authentication scheme of OAuth 2.0. Your Salesforce Marketing Cloud Account Engagement business-unit Id begins with “0Uv” and is 18 characters long. You can locate your Id from Marketing Setup in Salesforce. supports authenticating to Salesforce Marketing Cloud Account Engagement in several ways. Select your authentication method below to proceed to the relevant section that contains the authentication details.

​
OAuth

​
OAuth Password

To connect with the Password OAuth grant type, specify the following properties:
  • Auth Scheme: Select OAuthPassword.
  • User: Enter the username that you use to authenticate to Salesforce Marketing Cloud Account Engagement.
  • Password: Enter the password that you use to authenticate to Salesforce Marketing Cloud Account Engagement.
  • Security Token: Enter the security token that you use to authenticate to Salesforce Marketing Cloud Account Engagement.

​
OAuth JWT

To connect with Salesforce Marketing Cloud Account Engagement, specify the following properties:
  • Auth Scheme: Select OAuthJWT.
  • OAuth JWT Cert: Enter your Java web tokens (JWT) certificate store.
  • OAuth JWT Cert Type: Enter the type of key store that contains your JWT certificate. The default type is PEMKEY_BLOB.
  • OAuth JWT Issuer – Enter the issuer of your Java web token. Typically, the issuer is either the client Id or the email address of the OAuth application.
  • (Optional) OAuth JWT Cert Password: Enter the password for your OAuth JWT certificate.
  • (Optional) OAuth JWT Cert Subject: Enter the subject of your OAuth JWT certificate that is used to locate a matching certificate in the store. This property supports partical matches and a wildcard operator (*) to select the first certicate.
  • (Optional) OAuth JWT Subject: Enter the user subject that is used to locate a matching certificate in the store. This property supports partical matches and a wildcard operator (*) to select the first certicate.

​
Salesforce Marketing Cloud Account Engagement as a Reverse ETL Destination

In the application, you can configure Salesforce Marketing Cloud Account Engagement as a reverse ETL destination so that it can receive processed data from your source database or warehouse. Currently, the only supported object for this destination is the Prospects table, and all three transfer modes (Insert, Upsert, and Update) are available for that table. Other tables are not supported because the API does not provide bulk operations for them at this time. In Salesforce Marketing Cloud Account Engagement, you can use Email, ID, or SalesforceID as the delta snapshot key for updates (Update mode) to the Prospects table. For Upsert mode, you can use either Email or SalesforceID as the delta snapshot key. Note: If you choose to use Email, be aware of the implications of the Salesforce Marketing Cloud Account Engagement feature Allow Multiple Prospects with the Same Email Address (AMPSEA):
  • AMPSEA was enabled by default since June 14, 2016, and it cannot be turned off for business units that were created after that date or when the feature is enabled by an administrator.
  • When multiple prospects share the same email, operations that match on Email might resolve to the prospect with the most recent activity, which can lead to unexpected updates because the value for Email is not unique.
As a result of this behavior, Salesforce recommends that you use SalesforceID (the CRM ID) for imports whenever possible. Transfer-Modes Summary
ModeSupportedKey Used for MatchingNotes
InsertYesN/A (always inserts)Creates new records in the Prospects table.
UpdateYesUse either ID, SalesforceID, or EmailUpdates existing records in the Prospects table only.
UpsertYesUse either SalesforceID or EmailUpdates existing records if a matching key exists. If no match exists, a new record is inserted.

​
Complete Your Connection

To complete your connection:
  1. Specify the following properties:
    • Schema: Select the Salesforce Marketing Cloud Account Engagement version that you want to use. The default version is SalesforcePardotV5.
    • (Optional) Is Demo Account: Select whether the provided account is a demo account. By default, the Enable checkbox is not selected.
  2. Define advanced connection settings on the Advanced tab. (In most cases, though, you should not need these settings.)
  3. If you authenticate with OAuth, click Connect to Salesforce Marketing Cloud Account Engagement to connect to your Salesforce Marketing Cloud Account Engagement account.
  4. Click Create & Test to create your connection.