String
Salesforce Marketing Cloud Connector 4.1 Reference - Mule 4
Anypoint Connector for Salesforce Marketing Cloud (Salesforce Marketing Cloud Connector) enables you to connect to the Salesforce Marketing Cloud. This connector exposes convenient operations for exploiting the capabilities of Salesforce Marketing Cloud.
Configuration
Default Configuration for Salesforce Marketing Cloud Connector.
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Name |
Name for this configuration. Connectors reference the configuration with this name. |
x |
||
Connection |
Connection types for this configuration. |
x |
||
Read timeout |
Number |
How long the consumer waits for a response before timing out. |
|
|
Read timeout time unit |
Enumeration, one of:
|
Time unit for the Read timeout field. |
|
|
Name |
String |
ID used to reference this configuration. |
x |
|
Expiration Policy |
Configures the minimum amount of time that a dynamic configuration instance can remain idle before Mule considers it eligible for expiration. |
Basic Authentication Connection Type
Uses a username and a password for connection.
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Service URL |
String |
Base URL of the service on Salesforce Marketing Cloud to access from the connector. All other endpoints derive from this base URL. |
x |
|
Connection Timeout |
Number |
How long the connector waits before timing out when establishing a connection to the remote service. |
||
Connection Timeout Unit |
Enumeration, one of:
|
Time unit for the Connection Timeout field. |
|
|
Proxy configuration |
Configures a proxy for outbound connections. |
|||
WSDL file URL |
String |
URL of the WSDL file used by this connector. If unspecified, this parameter defaults to the service URL parameter host, but it appends |
||
Username |
String |
Username used to initialize the session. |
x |
|
Password |
String |
Password used to authenticate the user. |
x |
|
TLS configuration |
Configures TLS. If using the HTTPS protocol, you must configure TLS. |
|||
Reconnection |
Configures a reconnection strategy to use when a connector operation fails to connect to an external server. |
OAuth Client Credentials Connection Type
Use OAuth 2.0 to delegate user authentication to the service hosting the user account. For more information, refer to Configuring OAuth 2.0 for Connectors or Configuring OAuth 2.0 for Connectors on CloudHub.
Uses a client ID, client secret, and token URL for connection.
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Service URL |
String |
Base URL of the service on Salesforce Marketing Cloud to access from the connector. All other endpoints derive from this base URL. |
x |
|
Connection Timeout |
Number |
How long the connector waits before timing out when establishing a connection to the remote service. |
||
Connection Timeout Unit |
Enumeration, one of:
|
Time unit for the Connection Timeout field. |
|
|
Proxy configuration |
Configures a proxy for outbound connections. |
|||
WSDL file URL |
String |
URL of the WSDL file used by this connector. If unspecified, this parameter defaults to the service URL parameter host, but it appends |
||
Account Id |
String |
Account ID. |
||
TLS configuration |
Configures TLS. If using the HTTPS protocol, you must configure TLS. |
|||
Reconnection |
Configures a reconnection strategy to use when a connector operation fails to connect to an external server. |
|||
Client Id |
String |
OAuth client ID, as registered with the service provider. |
x |
|
Client Secret |
String |
OAuth client secret, as registered with the service provider. |
x |
|
Token Url |
String |
URL of the service provider’s token endpoint. |
|
|
Scopes |
String |
OAuth scopes to request during the OAuth dance. This value defaults to the scopes in the annotation. |
||
Object Store |
String |
Configures the object store that stores data for each resource owner. If not configured, Mule uses the default object store. |
Sources
On modified object
<sfdc-marketing-cloud:modified-object-listener>
Listener for modified objects.
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Since |
String |
Specifies a date in the |
||
Amount |
Number |
How long the consumer waits for a response before timing out. |
||
Time unit |
Enumeration, one of:
|
Time unit for the Amount field. |
||
Object type |
String |
Type of API object to retrieve. |
x |
|
Config Ref |
ConfigurationProvider |
Name of the configuration used to execute this component. |
x |
|
Primary Node Only |
Boolean |
Determines whether to execute this source on only the primary node when running Mule instances in a cluster. |
||
Scheduling Strategy |
Scheduling Strategy |
Configures the scheduler that triggers the polling. |
x |
|
Redelivery Policy |
Defines a policy for processing the redelivery of the same message. |
|||
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
On new object
<sfdc-marketing-cloud:new-object-listener>
Listener for new objects.
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Since |
String |
Specifies a date in the |
||
Amount |
Number |
How long the consumer waits for a response before timing out. |
||
Time unit |
Enumeration, one of:
|
Time unit for the Amount field. |
||
Object type |
String |
Type of API object to retrieve. |
x |
|
Config Ref |
ConfigurationProvider |
Name of the configuration used to execute this component. |
x |
|
Primary Node Only |
Boolean |
Determines whether to execute this source on only the primary node when running Mule instances in a cluster. |
||
Scheduling Strategy |
Scheduling Strategy |
Configures the scheduler that triggers the polling. |
x |
|
Redelivery Policy |
Defines a policy for processing the redelivery of the same message. |
|||
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
Operations
Configure action
<sfdc-marketing-cloud:configure>
Allows the configuration of actions.
When you map your objects to the input of this message processor, the objects must match the expected types of the objects in Salesforce Marketing Cloud. |
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Configurations |
Array of Object |
Array of one or more configurations to update. |
|
|
Configure Options |
Object |
Options for the operation. |
||
Config Ref |
ConfigurationProvider |
Name of the configuration used to execute this component. |
x |
|
Action |
String |
Type of action to perform. |
x |
|
Object Type |
String |
Type of object the action is performed on. |
x |
|
Amount |
Number |
How long the consumer waits for a response before timing out. |
||
Time unit |
Enumeration, one of:
|
Time unit for the Amount field. |
||
Target Variable |
String |
Name of the variable that stores the operation’s output. |
||
Target Value |
String |
Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field. |
|
|
Error Mappings |
Array of Error Mapping |
Set of error mappings. |
||
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
Create entities
<sfdc-marketing-cloud:create>
Creates one or more API objects.
When you map your objects to the input of this message processor, the objects must match the expected types of the objects in Salesforce Marketing Cloud. |
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Object Type |
String |
Type of API object to create. |
x |
|
Api Objects |
Array of Object |
Array of one or more API objects. |
|
|
CreateOptions |
Object |
Options for the operation. |
||
Config Ref |
ConfigurationProvider |
Name of the configuration used to execute this component. |
x |
|
Amount |
Number |
How long the consumer waits for a response before timing out. |
||
Time unit |
Enumeration, one of:
|
Time unit for the Amount field. |
||
Target Variable |
String |
Name of the variable that stores the operation’s output. |
||
Target Value |
String |
Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field. |
|
|
Error Mappings |
Array of Error Mapping |
Set of error mappings. |
||
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
Delete objects
<sfdc-marketing-cloud:delete>
Deletes one or more API objects from your organization’s data.
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Object Type |
String |
Type of object to delete. |
x |
|
Api Objects |
Array of Object |
Array of one or more API objects. |
|
|
DeleteOptions |
Object |
Options for the operation. |
||
Config Ref |
ConfigurationProvider |
Name of the configuration used to execute this component. |
x |
|
Amount |
Number |
How long the consumer waits for a response before timing out. |
||
Time unit |
Enumeration, one of:
|
Time unit for the Amount field. |
||
Target Variable |
String |
Name of the variable that stores the operation’s output. |
||
Target Value |
String |
Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field. |
|
|
Error Mappings |
Array of Error Mapping |
Set of error mappings. |
||
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
Perform action
<sfdc-marketing-cloud:perform>
Performs an action on a determined type of object.
When you map your objects to the input of this message processor, the objects must match the expected types of the objects in Salesforce Marketing Cloud. |
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Definitions |
Array of Object |
Array of one or more definitions for the operation. |
|
|
Perform Options |
Object |
Options for the operation. |
||
Config Ref |
ConfigurationProvider |
Name of the configuration used to execute this component. |
x |
|
Action |
String |
Type of action to perform. |
x |
|
Object Type |
String |
Type of object the action is performed on. |
x |
|
Amount |
Number |
How long the consumer waits for a response before timing out. |
||
Time unit |
Enumeration, one of:
|
Time unit for the Amount field. |
||
Target Variable |
String |
Name of the variable that stores the operation’s output. |
||
Target Value |
String |
Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field. |
|
|
Error Mappings |
Array of Error Mapping |
Set of error mappings. |
||
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
Retrieve entities
<sfdc-marketing-cloud:retrieve>
Enables the retrieval of a single object type. This operation retrieves specified object properties only. You can apply filters to ensure that only relevant results are returned. Only the properties that have values for the object are returned. If an object that is requested does not exist, no results are returned.
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Query |
String |
Query describing the objects that you want to retrieve. |
x |
|
RetrieveOptions |
Object |
Options for the operation. |
||
Config Ref |
ConfigurationProvider |
Name of the configuration used to execute this component. |
x |
|
Streaming Strategy |
|
Configures how Mule processes streams. Repeatable streams are the default behavior. |
||
Amount |
Number |
How long the consumer waits for a response before timing out. |
||
Time unit |
Enumeration, one of:
|
Time unit for the Amount field. |
||
Target Variable |
String |
Name of the variable that stores the operation’s output. |
||
Target Value |
String |
Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field. |
|
|
Error Mappings |
Array of Error Mapping |
Set of error mappings. |
||
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
Schedule start action
<sfdc-marketing-cloud:schedule-start>
Schedules an action or an event to occur at a specific time.
When you map your objects to the input of this message processor, the objects must match the expected types of the objects in Salesforce Marketing Cloud. |
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Object Type |
String |
Type of object on which to do a schedule. |
x |
|
Interactions |
Array of Object |
Array of one or more interactions in the operation. |
|
|
Schedule Definitions |
Object |
Schedule definition used for the operation. |
x |
|
Schedule Options |
Object |
Options for the operation. |
||
Config Ref |
ConfigurationProvider |
Name of the configuration used to execute this component. |
x |
|
Amount |
Number |
How long the consumer waits for a response before timing out. |
||
Time unit |
Enumeration, one of:
|
Time unit for the Amount field. |
||
Target Variable |
String |
Name of the variable that stores the operation’s output. |
||
Target Value |
String |
Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field. |
|
|
Error Mappings |
Array of Error Mapping |
Set of error mappings. |
||
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
Unauthorize
<sfdc-marketing-cloud:unauthorize>
Deletes all the access token information of a given resource owner ID so that it is impossible to execute any operation for that user without repeating the authorization dance.
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Config Ref |
ConfigurationProvider |
Name of the configuration used to execute this component. |
x |
Update entities
<sfdc-marketing-cloud:update>
Updates one or more API objects.
When you map your objects to the input of this message processor, the objects must match the expected types of the objects in Salesforce Marketing Cloud. |
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Object Type |
String |
Type of object to update. |
x |
|
Api Objects |
Array of Object |
Array of one or more API objects. |
|
|
UpdateOptions |
Object |
Options for the operation. |
||
Config Ref |
ConfigurationProvider |
Name of the configuration used to execute this component. |
x |
|
Amount |
Number |
How long the consumer waits for a response before timing out. |
||
Time unit |
Enumeration, one of:
|
Time unit for the Amount field. |
||
Target Variable |
String |
Name of the variable that stores the operation’s output. |
||
Target Value |
String |
Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field. |
|
|
Error Mappings |
Array of Error Mapping |
Set of error mappings. |
||
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
Upsert entities
<sfdc-marketing-cloud:upsert>
Upserts one or more API objects.
When you map your objects to the input of this message processor, the objects must match the expected types of the objects in Salesforce Marketing Cloud. This operation performs Create with the SaveAction in the CreateOptions for the fields set to UPDATE_ADD .
|
Name | Type | Description | Default Value | Required |
---|---|---|---|---|
Configuration |
String |
Name of the configuration to use. |
x |
|
Object Type |
String |
Type of API object to upsert. |
x |
|
Api Objects |
Array of Object |
Array of one or more API objects. |
|
|
UpsertOptions |
Object |
Options for the operation. |
||
Config Ref |
ConfigurationProvider |
Name of the configuration used to execute this component. |
x |
|
Amount |
Number |
How long the consumer waits for a response before timing out. |
||
Time unit |
Enumeration, one of:
|
Time unit for the Amount field. |
||
Target Variable |
String |
Name of the variable that stores the operation’s output. |
||
Target Value |
String |
Expression that evaluates the operation’s output. The outcome of the expression is stored in the Target Variable field. |
|
|
Error Mappings |
Array of Error Mapping |
Set of error mappings. |
||
Reconnection Strategy |
Retry strategy in case of connectivity errors. |
Object Types
Crl File
Specifies the location of the certification revocation list (CRL) file.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Path |
String |
Path to the CRL file. |
Custom Ocsp Responder
Configures a custom OCSP responder for certification revocation checks.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Url |
String |
URL of the OCSP responder. |
||
Cert Alias |
String |
Alias of the signing certificate for the OCSP response. If specified, the alias must be in the truststore. |
Error Mapping
Configures the error mapping of the connector.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Source |
Enumeration, one of:
|
Source of the error. |
||
Target |
String |
Target of the error. |
x |
Expiration Policy
Configures an expiration policy strategy.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Max Idle Time |
Number |
Configures the maximum amount of time that a dynamic configuration instance can remain idle before Mule considers it eligible for expiration. |
||
Time Unit |
Enumeration, one of:
|
Time unit for the Max Idle Time field. |
Key Store
Configures the keystore for the TLS protocol. The keystore you generate contains a private key and a public certificate.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Path |
String |
Path to the keystore. Mule resolves the path relative to the current classpath and file system. |
||
Type |
String |
Type of keystore. |
||
Alias |
String |
Alias of the key to use when the keystore contains multiple private keys. By default, Mule uses the first key in the file. |
||
Key Password |
String |
Password used to protect the private key. |
||
Password |
String |
Password used to protect the keystore. |
||
Algorithm |
String |
Encryption algorithm that the keystore uses. |
Proxy Configuration
Configures a proxy for outbound connections.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Host |
String |
Hostname or IP address of the proxy server. |
x |
|
Port |
Number |
Port of the proxy server. |
x |
|
Username |
String |
Username to authenticate against the proxy server. |
||
Password |
String |
Password to authenticate against the proxy server. |
||
Non Proxy Hosts |
String |
Comma-separated list of hosts that the proxy must not be used against. |
||
Ntlm Domain |
String |
Domain to authenticate against the proxy. |
Reconnect
Configures a standard reconnection strategy, which specifies how often to reconnect and how many reconnection attempts the connector source or operation can make.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Frequency |
Number |
How often to attempt to reconnect, in milliseconds. |
||
Blocking |
Boolean |
If |
||
Count |
Number |
How many reconnection attempts the Mule app can make. |
Reconnect Forever
Configures a forever reconnection strategy by which the connector source or operation attempts to reconnect at a specified frequency for as long as the Mule app runs.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Frequency |
Number |
How often to attempt to reconnect, in milliseconds. |
||
Blocking |
Boolean |
If |
Reconnection
Configures a reconnection strategy for an operation.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Fails Deployment |
Boolean |
What to do if, when an app is deployed, a connectivity test does not pass after exhausting the associated reconnection strategy:
|
||
Reconnection Strategy |
Reconnection strategy to use. |
Redelivery Policy
Configures the redelivery policy for executing requests that generate errors. You can add a redelivery policy to any source in a flow.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Max Redelivery Count |
Number |
Maximum number of times that a redelivered request can be processed unsuccessfully before returning a |
||
Message Digest Algorithm |
String |
Secure hashing algorithm to use if the Use Secure Hash field is |
||
Message Identifier |
One or more expressions that determine if a message was redelivered. This property can be set only if the Use Secure Hash field is |
|||
Object Store |
ObjectStore |
Configures the object store that stores the redelivery counter for each message. |
Redelivery Policy Message Identifier
Configures how to identify a redelivered message and how to find out when the message was redelivered.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Use Secure Hash |
Boolean |
If |
||
Id Expression |
String |
One or more expressions that determine when a message was redelivered. You can set this property only if the Use Secure Hash field is |
Repeatable File Store Iterable
Configures the repeatable file store iterable type.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
In Memory Objects |
Number |
Maximum amount of instances to keep in memory. If more than that is required, content on the disk is buffered. |
||
Buffer Unit |
Enumeration, one of:
|
Unit for the In Memory Objects field. |
Repeatable In Memory Iterable
Configures the repeatable in memory iterable type.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Initial Buffer Size |
Number |
Amount of instances to initially keep in memory to consume the stream and provide random access to it. If the stream contains more data than can fit into this buffer, then the buffer expands according to the Buffer Size Increment attribute, with an upper limit of Max In Memory Size. Default value is 100 instances. |
||
Buffer Size Increment |
Number |
Amount by which the buffer size expands if it exceeds its initial size. Setting a value of |
|
|
Max Buffer Size |
Number |
Maximum amount of memory to use. If more than that is used, a |
Standard Revocation Check
Configures standard revocation checks for TLS certificates.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Only End Entities |
Boolean |
Which elements to verify in the certificate chain:
|
||
Prefer Crls |
Boolean |
How to check certificate validity:
|
||
No Fallback |
Boolean |
Whether to use the secondary method to check certificate validity:
|
||
Soft Fail |
Boolean |
What to do if the revocation server can’t be reached or is busy:
|
TLS
Configures TLS to provide secure communications for the Mule app.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Enabled Protocols |
String |
Comma-separated list of protocols enabled for this context. |
||
Enabled Cipher Suites |
String |
Comma-separated list of cipher suites enabled for this context. |
||
Trust Store |
Configures the TLS truststore. |
|||
Key Store |
Configures the TLS keystore. |
|||
Revocation Check |
Configures a revocation checking mechanism. |
Trust Store
Configures the truststore for TLS.
Field | Type | Description | Default Value | Required |
---|---|---|---|---|
Path |
String |
Path to the truststore. Mule resolves the path relative to the current classpath and file system. |
||
Password |
String |
Password used to protect the truststore. |
||
Type |
String |
Type of truststore. |
||
Algorithm |
String |
Encryption algorithm that the truststore uses. |
||
Insecure |
Boolean |
If |