Skip to content

Salesforce Marketing Cloud

Salesforce logo

Integration type: User-defined

Supported functionality

Upload

  • Upload — You can upload a list to schedule then send using the ESP's own functionality
  • Upload & Broadcast — You can upload a list to the ESP to broadcast immediately

Broadcast

  • Email — You can create an email broadcast in Orbit and PeopleStage

Documentation

For the ability to upsert data from an Orbit campaign to your Salesforce Sales Cloud system, see Setting up your Salesforce custom object and table.

Channel configuration in Orbit

Note

Values shown may be for example only; the options will differ for each broadcaster.

Basic details

Name Description
Channel Name Enter a name for the channel
Broadcaster Select Salesforce from the drop-down
Broadcaster Username Enter your broadcaster API username, available from Salesforce
Broadcaster Password Enter your broadcaster API password, available from Salesforce
Update Password Displayed once a password has been set; use this to change the password if required
Test Login Use the Test Login button to confirm the above details are correct
Email Variable Select Email Address from the drop-down
Email Variable Description Override Optional—enter the description, for example "Email Address". This must correspond to the email field within Salesforce
Reply Email Address The email address that will receive notifications when the channel is used. This is NOT the reply email address used for the email send
Broadcaster Action The default is Upload and Broadcast; select Upload Only to upload the list only without initiating a broadcast

Broadcast parameters

Parameter Name Parameter Value
Authentication Base URI e.g. https://msem8vt6-nevvshs2m4rgf24jlw7.auth.marketingcloudapis.com/
Base URI e.g. https://msem8vt6-nevvshs2m4rgf24jlw7.rest.marketingcloudapis.com/
Client ID e.g. g2yTgel9ighz118ps6cWnq3j
Client Secret e.g. 8ps6cWnq3j9ighz11g2yTgel
API Timeout API timeout for the RESTful API in seconds (default is 300 seconds)
Business Unit Optional
URL SOAP Base URI e.g. https://msem8vt6-nevvshs2m4rgf24jlw7.soap.marketingcloudapis.com/
Triggered Send Definition
Use Triggered Sends
Sendable Setting this to false puts the data extension into non-sendable mode, useful if you only want to report on the data. Default is true
Publication List
Triggered Send Data Extension
Use URN as Subscriber Key Choose whether to use the URN as the subscriber key. Default is false
Subscriber Key Name
The Salesforce Send Classification e.g. Default Commercial
File Transfer Location Recommended: ExactTargetEnhanced FTP
Data Extension Retention Period
Owner Member ID Enter your owner member ID
Owner Member Name
URL The API URL, e.g. https://webservice.exacttarget.com/Service.asmx. Check with Salesforce
Upload and Broadcast Folder Absolute paths or parameters, e.g. Root\%LISTNAME%\%MESSAGENAME%
Upload Only Folder The message Upload Folder under the Data Extensions tree

Common parameters

Parameter Name Parameter Value
SFTP Private Key Path If secure FTP is used above and requires a private key, this should refer to the path and filename of that key
Use Dated List Setting this to false removes the date and time stamp at the end of the file name. Default is true
Dated List Format Enter the date format string for the date and time stamp. Default is yyyyMMdd-HHmmss
Name Value
Allow in Transactional Output Specific to PeopleStage and Transactional Campaigning. If you select Yes, multiple emails can be sent to the same email address
Append to List Optional
Number of Retries The number of times to retry on failure. Recommended (for Broadcast Channels) to leave this at 0
Response File Key Type The key field to match responses to sends. Should be set to Communication Key for Salesforce
Message Content Type For email broadcasts this will always be Template (using the Broadcaster Template)
Retrieve Existing List Names Optional; not supported in Orbit at the moment
Name Value
Zip File Default is deselected; select this to compress the file if required
Output File Format Default is Comma Separated Values (CSV)
Output Header Default is Descriptions
Delimiter Default is Tab
Alpha Encloser Default is None
Numeric Encloser Default is None
Extras Empty by default; reserved for advanced use
Encoding Default is UTF-8