Marketing Cloud Engagement for Appexchange API Guide
This guide presents the details needed to use the capabilities of Marketing Cloud Engagement for AppExchange via a SOAP (Simple Object Access Protocol) web service in your business application.
To begin to use these capabilities, your account must be fully configured for Marketing Cloud Engagement for AppExchange.
The Marketing Cloud Engagement for AppExchange API enables email to be sent to Salesforce.com reports, campaigns, contacts, or leads using a SOAP web service. The Marketing Cloud Engagement for AppExchange API web service supports many business scenarios. The architecture of the web service allows multiple send requests in a single call. Additionally, a send can consist of many Salesforce entities.
Some use cases for this feature include:
- A custom landing page that sends an individual confirmation email to a Salesforce.com Lead or Contact
- A Salesforce.com workflow that sends individual email based on Salesforce.com data events
- Sending mass email to one or many Salesforce.com Campaigns or Reports on a recurring basis triggered from an external application
- An application that creates a Marketing Cloud Engagement email based on Salesforce templates and sends the email to Salesforce.com entities.
To access Marketing Cloud Engagement for AppExchange web service, you must first contact your Account Executive to configure your account and create a service user. A service user is a combination of user permissions and user settings. A user in your account is given permissions to access the web service and has the API User setting checked. Users who have the API User setting checked are not subject to the account's security settings.
Use the correct address for your Marketing Cloud Engagement instance, and contact your Account Executive if you have any questions regarding which WSDL file to use. This table lists Marketing Cloud Engagement for Appexchange WSDL URLs.
| Instance | WSDL URL |
|---|---|
| S1 Instance | https://etappx.exacttarget.com/etframeworksf.wsdl |
| S4 Instance | https://etappx.s4.exacttarget.com/etframeworksf.wsdl |
| S6 Instance | https://etappx.s6.exacttarget.com/etframeworksf.wsdl |
| S7 Instance | https://etappx.s7.exacttarget.com/etframeworksf.wsdl |
These files define the objects and calls exposed to SOAP clients.
Authenticating to the Integration Framework requires passing a WS-Security 1.0 security token in the SOAP header.
This sample code demonstrates how to send to a single Salesforce Lead.