Contact Us 1-800-596-4880

Salesforce Marketing Cloud Connector 3.1 Reference - Mule 4

Configurations


Default Configuration

Parameters

Name Type Description Default Value Required

Name

String

The name for this configuration. Connectors reference the configuration with this name.

x

Connection

The connection types to provide to this configuration.

x

Read timeout

Number

Specifies the amount of time, in the unit defined in Service URL, that the consumer waits for a response before it times out.

0

Read timeout time unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

A time unit that qualifies the Read timeout.

SECONDS

Name

String

The identifier of this element used to reference it in other components.

x

Expiration Policy

Configures the minimum amount of time that a dynamic configuration instance can remain idle before Mule considers it eligible for expiration. This does not mean that the platform expires the instance at the exact moment that it becomes eligible. Mule purges the instances as appropriate.

Connection Types

Basic Authentication
Parameters
Name Type Description Default Value Required

Service URL

String

The base URL of the service on Salesforce Marketing Cloud to be accessed from the connector. From this base URL all other endpoints derive.

x

Connection Timeout

Number

The socket connection timeout value. This attribute works in tandem with Connection Timeout Unit.

Connection Timeout Unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

A time unit that qualifies the Connection Timeout.

SECONDS

Proxy configuration

Proxy configuration for the connector.

WSDL file URL

String

The URL of the WSDL file used by this connector. When no value is set, this parameter defaults to the Service URL parameter host, but it appends /etframework.wsdl at its end.

Username

String

Username used to initialize the session.

x

Password

String

Password used to authenticate the user.

x

TLS configuration

TLS

Protocol to use for communication. Valid values are HTTP and HTTPS. Default value is HTTP. When using HTTPS, the HTTP communication is secured using TLS / SSL. If HTTPS was configured as the protocol, the user needs to configure the keystore in the tls:context child element of this listener-config.

Reconnection

When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.

OAuth Client Credentials
Parameters
Connection Timeout Type Description Default Value Required

Service URL

String

The base URL of the service on Salesforce Marketing Cloud to be accessed from the connector. From this base URL all other endpoints derive.

x

Connection Timeout

Number

The socket connection timeout value. This attribute works in tandem with the Connection Timeout Unit.

Connection Timeout Unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

A time unit that qualifies the Connection Timeout.

SECONDS

Proxy configuration

Proxy configuration for the connector.

WSDL file URL

String

The URL of the WSDL file used by this connector. When no value is set, this parameter defaults to the Service URL parameter host, but it appends /etframework.wsdl at its end.

TLS configuration

TLS

Protocol to use for communication. Valid values are HTTP and HTTPS. Default value is HTTP. When using HTTPS, the HTTP communication is secured using TLS / SSL. If HTTPS was configured as the protocol, the user needs to configure at least the keystore in the tls:context child element of this listener-config.

Reconnection

When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.

Client Id

String

The OAuth client ID as registered with the service provider.

x

Client Secret

String

The OAuth client secret as registered with the service provider.

x

Token Url

String

The service provider’s token endpoint URL.

https://{domain}.auth.marketingcloudapis.com/v2/token

Scopes

String

The OAuth scopes to be requested during the dance. If not provided, it defaults to those in the annotation.

Object Store

String

A reference to the object store that should be used to store each resource owner id’s data. If not specified, runtime will automatically provision the default one.

Configure action

<sfdc-marketing-cloud:configure>

Operation that allows the configuration of actions. IMPORTANT: When you map your objects to the input of this message processor, keep in mind that they need to match the expected types of the objects in Salesforce Marketing Cloud.

Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

x

Configurations

Array of Object

An array of one or more configurations to be updated.

#[payload]

Configure Options

Object

Options that can be made on the configure operation.

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Action

String

The type of action to perform.

x

Object Type

String

The type of object being performed the action on.

x

Amount

Number

Specifies the amount of time, in the unit defined in Read timeout time unit, that the consumer waits for a response before it times out.

Time unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

A time unit that qualifies the Read timeout.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable.

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

Output

Type

Object

For Configurations

Throws

  • SFDC-MARKETING-CLOUD:CONNECTIVITY

  • SFDC-MARKETING-CLOUD:INVALID_INPUT

  • SFDC-MARKETING-CLOUD:PARSING

  • SFDC-MARKETING-CLOUD:RETRY_EXHAUSTED

  • SFDC-MARKETING-CLOUD:THROTTLED

Create entities

<sfdc-marketing-cloud:create>

Creates one or more API objects. IMPORTANT: When you map your objects to the input of this message processor, keep in mind that they need to match the expected types of the objects in Salesforce Marketing Cloud.

Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

x

Object Type

String

Type of API object to create.

x

Api Objects

Array of Object

An array of one or more API objects.

#[payload]

CreateOptions

Object

Options that can be made on the create operation.

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Amount

Number

Specifies the amount of time, in the unit defined in Read timeout time unit, that the consumer waits for a response before it times out.

Time unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

A time unit that qualifies the Read timeout.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable.

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

Output

Type

Object

For Configurations

Throws

  • SFDC-MARKETING-CLOUD:CONNECTIVITY

  • SFDC-MARKETING-CLOUD:INVALID_INPUT

  • SFDC-MARKETING-CLOUD:PARSING

  • SFDC-MARKETING-CLOUD:RETRY_EXHAUSTED

  • SFDC-MARKETING-CLOUD:THROTTLED

Delete objects

<sfdc-marketing-cloud:delete>

Deletes one or more API objects from your organization’s data.

Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

x

Object Type

String

Type of object to delete.

x

Api Objects

Array of Object

An array of one or more API objects .

#[payload]

DeleteOptions

Object

Options that can be made on the delete operation.

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Amount

Number

Specifies the amount of time, in the unit defined in Read timeout time unit, that the consumer waits for a response before it times out.

Time unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

A time unit that qualifies the Read timeout.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable.

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

Output

Type

Object

For Configurations

Throws

  • SFDC-MARKETING-CLOUD:CONNECTIVITY

  • SFDC-MARKETING-CLOUD:INVALID_INPUT

  • SFDC-MARKETING-CLOUD:PARSING

  • SFDC-MARKETING-CLOUD:RETRY_EXHAUSTED

  • SFDC-MARKETING-CLOUD:THROTTLED

Perform action

<sfdc-marketing-cloud:perform>

Performs an action on a determined type of object. IMPORTANT: When you map your objects to the input of this message processor, keep in mind that they need to match the expected types of the objects in Salesforce Marketing Cloud..

Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

x

Definitions

Array of Object

An array of one or more definitions for the perform operation.

Service URL[payload]

Perform Options

Object

Options that can be made on the perform operation.

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Action

String

The type of action to perform.

x

Object Type

String

The type of object being performed the action on.

x

Amount

Number

Specifies the amount of time, in the unit defined in Read timeout time unit, that the consumer waits for a response before it times out.

Time unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

A time unit that qualifies the Read timeout.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable.

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

Output

Type

Object

For Configurations

Throws

  • SFDC-MARKETING-CLOUD:CONNECTIVITY

  • SFDC-MARKETING-CLOUD:INVALID_INPUT

  • SFDC-MARKETING-CLOUD:PARSING

  • SFDC-MARKETING-CLOUD:RETRY_EXHAUSTED

  • SFDC-MARKETING-CLOUD:THROTTLED

Retrieve entities

<sfdc-marketing-cloud:retrieve>

The Retrieve method enables the retrieval of a single object type. This method retrieves specified object properties only. You can apply filters to Retrieve methods 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.

Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

x

Query

String

Query describing the objects that you want to retrieve.

x

RetrieveOptions

Object

Options that can be made on the update operation.

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Streaming Strategy

Configure if repeatable streams should be used and their behavior.

Amount

Number

Specifies the amount of time, in the unit defined in Read timeout time unit, that the consumer waits for a response before it times out.

Time unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

A time unit that qualifies the Read timeout.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable.

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

Output

Type

Array of Object

For Configurations

Throws

  • SFDC-MARKETING-CLOUD:INVALID_INPUT

  • SFDC-MARKETING-CLOUD:PARSING

  • SFDC-MARKETING-CLOUD:THROTTLED

Schedule start action

<sfdc-marketing-cloud:schedule-start>

Schedules an action or event to occur at a specific time. IMPORTANT: When you map your objects to the input of this message processor, keep in mind that they need to match the expected types of the objects in Salesforce Marketing Cloud.

Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

x

Object Type

String

Type of object on which to do a schedule.

x

Interactions

Array of Object

An array of one or more interactions in the schedule operation.

#[payload]

Schedule Definitions

Object

A schedule definition used for the schedule operation.

x

Schedule Options

Object

Options that can be made on the schedule operation.

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Amount

Number

Specifies the amount of time, in the unit defined in Read timeout time unit, that the consumer waits for a response before it times out.

Time unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

A time unit that qualifies the Read timeout.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable.

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

Output

Type

Object

For Configurations

Throws

  • SFDC-MARKETING-CLOUD:CONNECTIVITY

  • SFDC-MARKETING-CLOUD:INVALID_INPUT

  • SFDC-MARKETING-CLOUD:PARSING

  • SFDC-MARKETING-CLOUD:RETRY_EXHAUSTED

  • SFDC-MARKETING-CLOUD:THROTTLED

Unauthorize

<sfdc-marketing-cloud:unauthorize>

Deletes all the access token information of a given resource owner ID so that it’s impossible to execute any operation for that user without repeating the authorization dance.

Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

x

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

For Configurations

Update entities

<sfdc-marketing-cloud:update>

Updates one or more API objects. IMPORTANT: When you map your objects to the input of this message processor, keep in mind that they need to match the expected types of the objects in Salesforce Marketing Cloud.

Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

x

Object Type

String

Type of object to update.

x

Api Objects

Array of Object

An array of one or more API objects .

#[payload]

UpdateOptions

Object

Options that can be made on the update operation.

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Amount

Number

Specifies the amount of time, in the unit defined in Read timeout time unit, that the consumer waits for a response before it times out.

Time unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

A time unit that qualifies the Read timeout.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable.

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

Output

Type

Object

For Configurations

Throws

  • SFDC-MARKETING-CLOUD:CONNECTIVITY

  • SFDC-MARKETING-CLOUD:INVALID_INPUT

  • SFDC-MARKETING-CLOUD:PARSING

  • SFDC-MARKETING-CLOUD:RETRY_EXHAUSTED

  • SFDC-MARKETING-CLOUD:THROTTLED

Upsert entities

<sfdc-marketing-cloud:upsert>

Upserts one or more API objects. IMPORTANT: When you map your objects to the input of this message processor, keep in mind that they need to 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.

Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

x

Object Type

String

Type of API object to upsert

x

Api Objects

Array of Object

An array of one or more API objects .

#[payload]

UpsertOptions

Object

Options that can be made on the upsert operation.

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Amount

Number

Specifies the amount of time, in the unit defined in Read timeout time unit, that the consumer waits for a response before it times out.

Time unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

A time unit that qualifies the Read timeout.

Target Variable

String

The name of a variable to store the operation’s output.

Target Value

String

An expression to evaluate against the operation’s output and store the expression outcome in the target variable.

#[payload]

Reconnection Strategy

A retry strategy in case of connectivity errors.

Output

Type

Object

For Configurations

Throws

  • SFDC-MARKETING-CLOUD:CONNECTIVITY

  • SFDC-MARKETING-CLOUD:INVALID_INPUT

  • SFDC-MARKETING-CLOUD:PARSING

  • SFDC-MARKETING-CLOUD:RETRY_EXHAUSTED

  • SFDC-MARKETING-CLOUD:THROTTLED

Sources

On modified object

<sfdc-marketing-cloud:modified-object-listener>

Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

x

Since

String

Specify a date in the yyyy-MM-dd HH:mm:ss format (for example, 2017-03-17 16:30:40) to retrieve the selected objects.

Amount

Number

Specifies the amount of time, in the unit defined in Read timeout time unit, that the consumer waits for a response before it times out.

Time unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

A time unit that qualifies the Read timeout.

Object type

String

x

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Primary Node Only

Boolean

Whether this source should only be executed on the primary node when running 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

A retry strategy in case of connectivity errors.

Output

Type

Object

Attributes Type

Any

For Configurations

On new object

<sfdc-marketing-cloud:new-object-listener>

Parameters

Name Type Description Default Value Required

Configuration

String

The name of the configuration to use.

x

Since

String

Specify a date in the yyyy-MM-dd HH:mm:ss format (that is, 2017-03-17 16:30:40) to retrieve the selected objects.

Amount

Number

Specifies the amount of time, in the unit defined in Read timeout time unit, that the consumer waits for a response before it times out.

Time unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

A time unit that qualifies the Read timeout.

Object type

String

x

Config Ref

ConfigurationProvider

The name of the configuration to use to execute this component.

x

Primary Node Only

Boolean

Whether this source should only be executed on the primary node when running 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

A retry strategy in case of connectivity errors.

Output

Type

Object

Attributes Type

Any

For Configurations

Types

Proxy Configuration

Field Type Description Default Value Required

Host

String

Host where the proxy requests is sent.

x

Port

Number

Port where the proxy requests is sent.

x

Username

String

The username to authenticate against the proxy.

Password

String

The password to authenticate against the proxy.

Non Proxy Hosts

Array of String

A list of hosts against which the proxy should not be used.

Ntlm Domain

String

The domain to authenticate against the proxy.

TLS

Field Type Description Default Value Required

Enabled Protocols

String

A comma-separated list of protocols enabled for this context.

Enabled Cipher Suites

String

A comma-separated list of cipher suites enabled for this context.

Trust Store

Key Store

Revocation Check

Trust Store

Field Type Description Default Value Required

Path

String

The location (which will be resolved relative to the current classpath and file system, if possible) of the truststore.

Password

String

The password used to protect the truststore.

Type

String

The type of store used.

Algorithm

String

The algorithm used by the truststore.

Insecure

Boolean

If true, no certificate validations will be performed, rendering connections vulnerable to attacks. Use at your own risk.

Key Store

Field Type Description Default Value Required

Path

String

The location (which will be resolved relative to the current classpath and file system, if possible) of the keystore.

Type

String

The type of store used.

Alias

String

When the keystore contains many private keys, this attribute indicates the alias of the key that should be used. If not defined, the first key in the file will be used by default.

Key Password

String

The password used to protect the private key.

Password

String

The password used to protect the keystore.

Algorithm

String

The algorithm used by the keystore.

Standard Revocation Check

Field Type Description Default Value Required

Only End Entities

Boolean

Only verify the last element of the certificate chain.

Prefer Crls

Boolean

Try CRL instead of OCSP first.

No Fallback

Boolean

Do not use the secondary checking method (the one not selected before).

Soft Fail

Boolean

Avoid verification failure when the revocation server cannot be reached or is busy.

Custom Ocsp Responder

Field Type Description Default Value Required

Url

String

The URL of the OCSP responder.

Cert Alias

String

Alias of the signing certificate for the OCSP response (must be in the truststore), if present.

Crl File

Field Type Description Default Value Required

Path

String

The path to the CRL file.

Reconnection

Field Type Description Default Value Required

Fails Deployment

Boolean

When the application is deployed, a connectivity test is performed on all connectors. If set to true, deployment fails if the test doesn’t pass after exhausting the associated reconnection strategy.

Reconnection Strategy

The reconnection strategy to use.

Reconnect

Field Type Description Default Value Required

Frequency

Number

How often in milliseconds to reconnect.

Count

Number

How many reconnection attempts to make.

blocking

Boolean

If false, the reconnection strategy runs in a separate, non-blocking thread.

true

Reconnect Forever

Field Type Description Default Value Required

Frequency

Number

How often in milliseconds to reconnect.

blocking

Boolean

If false, the reconnection strategy runs in a separate, non-blocking thread.

true

Expiration Policy

Field Type Description Default Value Required

Max Idle Time

Number

A scalar time value for the maximum amount of time a dynamic configuration instance should be allowed to be idle before it’s considered eligible for expiration.

Time Unit

Enumeration, one of:

  • NANOSECONDS

  • MICROSECONDS

  • MILLISECONDS

  • SECONDS

  • MINUTES

  • HOURS

  • DAYS

A time unit that qualifies the maxIdleTime attribute.

Redelivery Policy

Field Type Description Default Value Required

Max Redelivery Count

Number

The maximum number of times a message can be redelivered and processed unsuccessfully before triggering process-failed-message.

Message Digest Algorithm

String

The secure hashing algorithm to use. If not set, the default is SHA-256.

Message Identifier

Defines which strategy is used to identify the messages.

Object Store

ObjectStore

The object store where the redelivery counter for each message is stored.

Redelivery Policy Message Identifier

Field Type Description Default Value Required

Use Secure Hash

Boolean

Whether to use a secure hash algorithm to identify a redelivered message.

Id Expression

String

Defines one or more expressions to use to determine when a message has been redelivered. This property can be set only if useSecureHash is false.

Repeatable In Memory Iterable

Field Type Description Default Value Required

Initial Buffer Size

Number

The amount of instances that are initially be allowed to be kept 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 bufferSizeIncrement attribute, with an upper limit of maxInMemorySize. Default value is 100 instances.

Buffer Size Increment

Number

This is by how much the buffer size expands if it exceeds its initial size. Setting a value of zero or lower means that the buffer should not expand, meaning that a STREAM_MAXIMUM_SIZE_EXCEEDED error is raised when the buffer gets full. Default value is 100 instances.

Max Buffer Size

Number

The maximum amount of memory to use. If more than that is used then a STREAM_MAXIMUM_SIZE_EXCEEDED error is raised. A value lower than or equal to zero means no limit.

Repeatable File Store Iterable

Field Type Description Default Value Required

In Memory Objects

Number

The maximum amount of instances to keep in memory. If more than that is required, then it will start to buffer the content on disk.

Buffer Unit

Enumeration, one of:

  • BYTE

  • KB

  • MB

  • GB

The unit in which maxInMemorySize is expressed.

View on GitHub