Salesforce Email Studio OAuth2 (ExactTarget) Connector Setup Guide

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 displays the authentication information.
9. Copy the following values to use later in the connector configuration:

• Client ID
• Client Secret
• SOAP Base URI

1. 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

  • Required.
  • Provide your app client ID.
  • See: Get OAuth Client Credentials

• 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 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 the “ubscriber 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	Map values to keys to include dynamic contents in your email and a sample input, see: Passing Content to a Triggered Send Message at Send Time. To manage your Profile Attributes, see: Profile and Preference Attributes.
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	Optional. 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	Optional. 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)	Optional. Select one or more email lists to add subscriber to.
User Status	Optional. Select value to update user’s status to.
Enable Asynchronous Processing	Optional. 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

Batch Limits

This action uses batched requests to support high-volume data transfers to the vendor. For more information, see Batched Actions. Requests are queued until one of the following thresholds is met or the profile is published:

• Max number of requests: 1000
• Max time since oldest request: 10 minutes
• Max size of requests: 1 MB

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. The dropdown list of Data Extensions is listed from newest to oldest and shows a maximum of 2000 entries. If a Data Extension is not shown in the dropdown list, paste the Data Extension External Key from the Data Extension details page in Salesforce, then press Enter to use that Data Extension.
Record Fields	Required. Map values to fields to add new record to data extension.
Enable Asynchronous Processing	Optional. 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

Batch Limits

This action uses batched requests to support high-volume data transfers to the vendor. For more information, see Batched Actions. Requests are queued until one of the following thresholds is met or the profile is published:

• Max number of requests: 1000
• Max time since oldest request: 10 minutes
• Max size of requests: 1 MB

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. The dropdown list of Data Extensions is listed from newest to oldest and shows a maximum of 2000 entries. If a Data Extension is not shown in the dropdown list, paste the Data Extension External Key from the Data Extension details page in Salesforce, then press Enter to use that Data Extension.
Record Fields	Required. Map array type attributes to add multiple data extension records. Array type attributes must be of equal length. Single value attributes can be used and will apply to each record.
Enable Asynchronous Processing	Optional. 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

Batch Limits

This action uses batched requests to support high-volume data transfers to the vendor. For more information, see Batched Actions. Requests are queued until one of the following thresholds is met or the profile is published:

• Max number of requests: 1000
• Max time since oldest request: 10 minutes
• Max size of requests: 1 MB

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. The dropdown list of Data Extensions is listed from newest to oldest and shows a maximum of 2000 entries. If a Data Extension is not shown in the dropdown list, paste the Data Extension External Key from the Data Extension details page in Salesforce, then press Enter to use that Data Extension.
Record Lookup	Required. Map values to record files by which to find existing record to delete.
Enable Asynchronous Processing	Optional. 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

Batch Limits

This action uses batched requests to support high-volume data transfers to the vendor. For more information, see Batched Actions. Requests are queued until one of the following thresholds is met or the profile is published:

• Max number of requests: 1000
• Max time since oldest request: 10 minutes
• Max size of requests: 1 MB

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. The dropdown list of Data Extensions is listed from newest to oldest and shows a maximum of 2000 entries. If a Data Extension is not shown in the dropdown list, paste the Data Extension External Key from the Data Extension details page in Salesforce, then press Enter to use that Data Extension.
Record Lookup	Required. Map values to record fields by which to find existing record to update.
Enable Asynchronous Processing	Optional. 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

Batch Limits

This action uses batched requests to support high-volume data transfers to the vendor. For more information, see Batched Actions. Requests are queued until one of the following thresholds is met or the profile is published:

• Max number of requests: 1000
• Max time since oldest request: 10 minutes
• Max size of requests: 1 MB

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. The dropdown list of Data Extensions is listed from newest to oldest and shows a maximum of 2000 entries. If a Data Extension is not shown in the dropdown list, paste the Data Extension External Key from the Data Extension details page in Salesforce, then press Enter to use that Data Extension.
Record Lookup	Required. Map values to record fields by which to find existing record to update.
Enable Asynchronous Processing	Optional. 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

• Salesforce Marketing Cloud: Create an OAuth 2.0 API Integration in Enhanced Packages
• Salesforce Marketing Cloud: API Integration
• Salesforce Marketing Cloud: Authenticate Your SOAP API Calls