This article describes how to set up the Salesforce Email Studio OAuth2 (ExactTarget) connector in your Customer Data Hub account.

In this article:

Table of Contents Placeholder

Prerequisites

  • Salesforce Marketing Cloud Account
  • Salesforce Marketing Cloud App Client Credentials
  • Appropriate permissions set on the Salesforce Marketing Cloud App

Connect Using the OAuth2 Authentication Scheme

Use the following steps to connect Tealium to ExactTarget using OAuth2 authentication scheme:

  1. Log into your ExactTarget account and from the top right menu, select Setup.
  2. Navigate to Platform Tools > Apps > Installed Packages.
  3. At the top right of the Installed Packages panel, click New to create a new package.
  4. In the opened dialog box, name your package and click Save.
  5. In the newly created package, click Add Component.
  6. Select API Integration as the component type and Server-to-Server as the integration type.
  7. Set appropriate Server-to-Server properties.
    If correct permissions are not provided, the integration may fail. Changing permissions after the package has been created may require some wait time for the permissions to apply.
  8. Save your component.
    In the package window, the component named API Integration shows the authentication information.
  9. Copy the following values to use later in the connector configuration:
    • Client ID
    • Client Secret
    • SOAP Base URI
  10. Also copy your account's MID value, found in the top menu bar.

Connector Actions

Action Name AudienceStream EventStream
Send Email to User
Add to Email List
Remove from Email List
Upsert Subscriber and Add to Email List(s)
Data Extension - Add Record
Data Extension - Add Multiple Records
Data Extension - Delete Record
Data Extension - Update Record
Data Extension - Upsert Record

Configure Settings

Go to the Connector Marketplace and add a new connector. Read the Connector Overview article for general instructions on how to add a connector.

After adding the connector, configure the following settings:

This connector requires the following information to connect to ExactTarget's SOAP protocol, upgraded with OAuth2 authentication scheme.

  • Market Cloud App Client ID
  • Client Secret: Required: provide your app client secret
  • Account ID
    • Required.
    • Provide account identifier (MID) of the target business unit.
  • Tenant-specific subdomain
    • Required: provide tenant-specific subdomain for your application.
    • If your SOAP Base URL looks something like this: https://mctg-xxxxxx.soap.marketingcloudapis.com/, then provide the portion of this URL between two slashes and the first period, in this example it would be mctg-xxxxxx.
    • The connector will automatically augment this subdomain name with correct suffixes for authentication and for SOAP messaging.
  • ExactTarget Account ID (MID)

Action Settings - Parameters and Options

Click Next or go to the Actions tab. This is where you configure connector actions.

See Salesforce Marketing Cloud Email Studio (Legacy authentication) for details about actions setup.

This section describes how to set up parameters and options for each action.

Action - Send Email to User

Parameters

Parameter Description
Business Unit
  • Recommended.
  • Select appropriate business unit.
  • If not specified then default option will be used, which corresponds to default business unit of configured Marketing Cloud user.
Triggered Send Email Interaction
  • Required.
  • Select triggered send email interaction.
Subscriber Lookup By Key
  • Required.
  • Lookup existing subscriber by key to send them an email.
Disable Subscriber Lookup
  • To disable lookup, check "Disable Subscriber Lookup" and configure "Subscriber Email" section.
Subscriber Email
  • Provide email to send message to (required if subscriber lookup is disabled).
  • Email can be left blank to use looked-up subscriber's email instead.
Attributes to Add or Overwrite
Don't Send Email to Subscriber with Status
  • If looked-up subscriber has one of the following statuses then do not send the email.
Enable Asynchronous Processing
  • Check option to enable asynchronous processing. API calls will be queued before being processed, rather than directly at the time the API call is received.
  • Async API calls are generally faster to complete and always return successful responses, even if underlying queued operation fails at a later point.
  • For more information, see: Asynchronous Processing.

Action - Add to Email List

Parameters

Parameter Description
Business Unit
  • Recommended.
  • Select appropriate business unit.
  • If not specified then default option will be used, which corresponds to default business unit of configured Marketing Cloud user.
Email List
  • Required.
  • Select email list.
Subscriber Lookup By Key
  • Required.
  • Provide subscriber key to find existing subscriber.
Enable Asynchronous Processing
  • Check option to enable asynchronous processing.
  • API calls will be queued before being processed, rather than directly at the time the API call is received.
  • Async API calls are generally faster to complete and always return successful responses, even if underlying queued operation fails at a later point.
  • For more information, see: Asynchronous Processing.

Action - Remove from Email List

Parameters

Parameter Description
Business Unit
  • Recommended.
  • Select appropriate business unit.
  • If not specified then default option will be used, which corresponds to default business unit of configured Marketing Cloud user.
Email List
  • Required.
  • Select email list.
Subscriber Lookup By Key
  • Required.
  • Provide subscriber key to find existing subscriber.
Enable Asynchronous Processing
  • Check option to enable asynchronous processing.
  • API calls will be queued before being processed, rather than directly at the time the API call is received.
  • Async API calls are generally faster to complete and always return successful responses, even if underlying queued operation fails at a later point.
  • For more information, see: Asynchronous Processing.

Action - Upsert Subscriber and Add to Email List(s)

Parameters

Parameter Description
Business Unit
  • Recommended.
  • Select appropriate business unit.
  • If not specified then default option will be used, which corresponds to default business unit of configured Marketing Cloud user.
Subscriber Key
  • Required.
Subscriber Email Address
  • Required.
Add Subscriber to Email List(s)
  • Select one or more email lists to add subscriber to.
User Status
  • Select value to update user's status to.
Enable Asynchronous Processing
  • Check option to enable asynchronous processing.
  • API calls will be queued before being processed, rather than directly at the time the API call is received.
  • Async API calls are generally faster to complete and always return successful responses, even if underlying queued operation fails at a later point.
  • For more information, see: Asynchronous Processing.

Action - Data Extension - Add Record

Parameters

Parameter Description
Business Unit
  • Recommended.
  • Select appropriate business unit.
  • If not specified then default option will be used, which corresponds to default business unit of configured Marketing Cloud user.
Data Extension
  • Required.
  • Select data extension.
Enable Asynchronous Processing
  • Check option to enable asynchronous processing.
  • API calls will be queued before being processed, rather than directly at the time the API call is received.
  • Async API calls are generally faster to complete and always return successful responses, even if underlying queued operation fails at a later point.
  • For more information, see: Asynchronous Processing.

Action - Data Extension - Add Multiple Records

Parameters

Parameter Description
Business Unit
  • Recommended.
  • Select appropriate business unit.
  • If not specified then default option will be used, which corresponds to default business unit of configured Marketing Cloud user.
Data Extension
  • Required.
  • Select data extension.
Enable Asynchronous Processing
  • Check option to enable asynchronous processing.
  • API calls will be queued before being processed, rather than directly at the time the API call is received.
  • Async API calls are generally faster to complete and always return successful responses, even if underlying queued operation fails at a later point.
  • For more information, see: Asynchronous Processing.

Action - Data Extension - Delete Record

Parameters

Parameter Description
Business Unit
  • Recommended.
  • Select appropriate business unit.
  • If not specified then default option will be used, which corresponds to default business unit of configured Marketing Cloud user.
Data Extension
  • Required.
  • Select data extension.
Enable Asynchronous Processing
  • Check option to enable asynchronous processing.
  • API calls will be queued before being processed, rather than directly at the time the API call is received.
  • Async API calls are generally faster to complete and always return successful responses, even if underlying queued operation fails at a later point.
  • For more information, see: Asynchronous Processing.

Action - Data Extension - Update Record

Parameters

Parameter Description
Business Unit
  • Recommended.
  • Select appropriate business unit.
  • If not specified then default option will be used, which corresponds to default business unit of configured Marketing Cloud user.
Data Extension
  • Required.
  • Select data extension.
Enable Asynchronous Processing
  • Check option to enable asynchronous processing.
  • API calls will be queued before being processed, rather than directly at the time the API call is received.
  • Async API calls are generally faster to complete and always return successful responses, even if underlying queued operation fails at a later point.
  • For more information, see: Asynchronous Processing.

Action - Data Extension - Upsert Record

Parameters

Parameter Description
Business Unit
  • Recommended:.
  • elect appropriate business unit.
  • If not specified then DEFAULT option will be used, which corresponds to default business unit of configured Marketing Cloud user.
Data Extension
  • Required.
  • Select data extension.
Enable Asynchronous Processing
  • Check option to enable asynchronous processing.
  • API calls will be queued before being processed, rather than directly at the time the API call is received.
  • Async API calls are generally faster to complete and always return successful responses, even if underlying queued operation fails at a later point.
  • For more information, see: Asynchronous Processing.

Vendor Documentation

Version history
Revision #:
11 of 11
Last update:
‎03-11-2020 01:53 PM
Updated by: