Salesforce Marketing Cloud Connector 4.1 Reference | MuleSoft Documentation
# Salesforce Marketing Cloud Connector 4.1 Reference
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 for this configuration. Connectors reference the configuration with this name.  
**Connection** | 
  * Basic Authentication
  * OAuth Client Credentials

|  Connection types for this configuration.  
**Read timeout** |  How long the consumer waits for a response before timing out.  
**Read timeout time unit** |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

|  Time unit for the **Read timeout** field.  
ID used to reference this configuration.  
**Expiration Policy** |  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** |  Base URL of the service on Salesforce Marketing Cloud to access from the connector. All other endpoints derive from this base URL.  
**Connection Timeout** |  How long the connector waits before timing out when establishing a connection to the remote service.  
**Connection Timeout Unit** |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

|  Time unit for the **Connection Timeout** field.  
**Proxy configuration** |  Proxy Configuration |  Configures a proxy for outbound connections.  
**WSDL file URL** |  URL of the WSDL file used by this connector. If unspecified, this parameter defaults to the service URL parameter host, but it appends `/etframework.wsdl` to the end.  
Username used to initialize the session.  
Password used to authenticate the user.  
**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** |  Base URL of the service on Salesforce Marketing Cloud to access from the connector. All other endpoints derive from this base URL.  
**Connection Timeout** |  How long the connector waits before timing out when establishing a connection to the remote service.  
**Connection Timeout Unit** |  Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

|  Time unit for the **Connection Timeout** field.  
**Proxy configuration** |  Proxy Configuration |  Configures a proxy for outbound connections.  
**WSDL file URL** |  URL of the WSDL file used by this connector. If unspecified, this parameter defaults to the service URL parameter host, but it appends `/etframework.wsdl` to the end.  
**Account Id** |  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.  
OAuth client ID, as registered with the service provider.  
**Client Secret** |  OAuth client secret, as registered with the service provider.  
URL of the service provider’s token endpoint. |  `https://{domain}.auth.marketingcloudapis.com/v2/token`  
OAuth scopes to request during the OAuth dance. This value defaults to the scopes in the annotation.  
**Object Store** |  Configures the object store that stores data for each resource owner. If not configured, Mule uses the default object store.  
## Sources
  * On modified object
  * 

### On modified object
`<sfdc-marketing-cloud:modified-object-listener>`
Listener for modified objects.
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
**Configuration** |  Name of the configuration to use.  
Specifies a date in the `yyyy-MM-dd HH:mm:ss` format, for example, `2017-03-17 16:30:40`, to retrieve the selected objects.  
How long the consumer waits for a response before timing out.  
Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

|  Time unit for the **Amount** field.  
**Object type** |  Type of API object to retrieve.  
**Config Ref** |  ConfigurationProvider |  Name of the configuration used to execute this component.  
**Primary Node Only** |  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.  
**Redelivery Policy** |  Redelivery Policy |  Defines a policy for processing the redelivery of the same message.  
**Reconnection Strategy** | 
  *   * Reconnect Forever

|  Retry strategy in case of connectivity errors.  
#### Output
Attributes Type  
---  
#### Associated Configurations
  * Configuration


### On new object
`<sfdc-marketing-cloud:new-object-listener>`
Listener for new objects.
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
**Configuration** |  Name of the configuration to use.  
Specifies a date in the `yyyy-MM-dd HH:mm:ss` format, for example, `2017-03-17 16:30:40`, to retrieve the selected objects.  
How long the consumer waits for a response before timing out.  
Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

|  Time unit for the **Amount** field.  
**Object type** |  Type of API object to retrieve.  
**Config Ref** |  ConfigurationProvider |  Name of the configuration used to execute this component.  
**Primary Node Only** |  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.  
**Redelivery Policy** |  Redelivery Policy |  Defines a policy for processing the redelivery of the same message.  
**Reconnection Strategy** | 
  *   * Reconnect Forever

|  Retry strategy in case of connectivity errors.  
#### Output
Attributes Type  
---  
#### Associated Configurations
  * Configuration


## Operations
  * Configure action
  * Create entities
  * Delete objects
  * Perform action
  * Retrieve entities
  * Schedule start action
  *   * Update entities
  * Upsert entities


### 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** |  Name of the configuration to use.  
**Configurations** |  Array of Object |  Array of one or more configurations to update.  
**Configure Options** |  Options for the operation.  
**Config Ref** |  ConfigurationProvider |  Name of the configuration used to execute this component.  
Type of action to perform.  
**Object Type** |  Type of object the action is performed on.  
How long the consumer waits for a response before timing out.  
Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

|  Time unit for the **Amount** field.  
**Target Variable** |  Name of the variable that stores the operation’s output.  
**Target Value** |  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** | 
  *   * Reconnect Forever

|  Retry strategy in case of connectivity errors.  
#### Output
Attributes Type  
---  
#### Associated Configurations
  * Configuration
|  Time unit for the **Amount** field.  
**Target Variable** |  Name of the variable that stores the operation’s output.  
**Target Value** |  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** | 
  *   * Reconnect Forever

|  Retry strategy in case of connectivity errors.  
#### Output
Attributes Type  
---  
#### Associated Configurations
  * Configuration


#### Throws
  * SFDC-MARKETING-CLOUD:CONNECTIVITY
  * SFDC-MARKETING-CLOUD:ERROR_RESPONSE
  * SFDC-MARKETING-CLOUD:INVALID_INPUT
  * SFDC-MARKETING-CLOUD:PARSING
  * SFDC-MARKETING-CLOUD:RETRY_EXHAUSTED


### 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** |  Name of the configuration to use.  
**Object Type** |  Type of API object to create.  
**Api Objects** |  Array of Object |  Array of one or more API objects.  
**CreateOptions** |  Options for the operation.  
**Config Ref** |  ConfigurationProvider |  Name of the configuration used to execute this component.  
How long the consumer waits for a response before timing out.  
Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

|  Time unit for the **Amount** field.  
**Target Variable** |  Name of the variable that stores the operation’s output.  
**Target Value** |  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** | 
  *   * Reconnect Forever

|  Retry strategy in case of connectivity errors.  
#### Output
Attributes Type  
---  
#### Associated Configurations
  * Configuration


#### Throws
  * SFDC-MARKETING-CLOUD:CONNECTIVITY
  * SFDC-MARKETING-CLOUD:ERROR_RESPONSE
  * SFDC-MARKETING-CLOUD:INVALID_INPUT
  * SFDC-MARKETING-CLOUD:PARSING
  * SFDC-MARKETING-CLOUD:RETRY_EXHAUSTED


### Delete objects
`<sfdc-marketing-cloud:delete>`
Deletes one or more API objects from your organization’s data.
Name | Type | Description | Default Value | Required  
---|---|---|---|---  
**Configuration** |  Name of the configuration to use.  
**Object Type** |  Type of object to delete.  
**Api Objects** |  Array of Object |  Array of one or more API objects.  
**DeleteOptions** |  Options for the operation.  
**Config Ref** |  ConfigurationProvider |  Name of the configuration used to execute this component.  
How long the consumer waits for a response before timing out.  
Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

|  Time unit for the **Amount** field.  
**Target Variable** |  Name of the variable that stores the operation’s output.  
**Target Value** |  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** | 
  *   * Reconnect Forever

|  Retry strategy in case of connectivity errors.  
#### Output
Attributes Type  
---  
#### Associated Configurations
  * Configuration


#### Throws
  * SFDC-MARKETING-CLOUD:CONNECTIVITY
  * SFDC-MARKETING-CLOUD:ERROR_RESPONSE
  * SFDC-MARKETING-CLOUD:INVALID_INPUT
  * SFDC-MARKETING-CLOUD:PARSING
  * SFDC-MARKETING-CLOUD:RETRY_EXHAUSTED


### 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** |  Name of the configuration to use.  
**Definitions** |  Array of Object |  Array of one or more definitions for the operation. |  `Service URL[payload]`  
**Perform Options** |  Options for the operation.  
**Config Ref** |  ConfigurationProvider |  Name of the configuration used to execute this component.  
Type of action to perform.  
**Object Type** |  Type of object the action is performed on.  
How long the consumer waits for a response before timing out.  
Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

|  Time unit for the **Amount** field.  
**Target Variable** |  Name of the variable that stores the operation’s output.  
**Target Value** |  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** | 
  *   * Reconnect Forever

|  Retry strategy in case of connectivity errors.  
#### Output
Attributes Type  
---  
#### Associated Configurations
  * Configuration


#### Throws
  * SFDC-MARKETING-CLOUD:CONNECTIVITY
  * SFDC-MARKETING-CLOUD:ERROR_RESPONSE
  * SFDC-MARKETING-CLOUD:INVALID_INPUT
  * SFDC-MARKETING-CLOUD:PARSING
  * SFDC-MARKETING-CLOUD:RETRY_EXHAUSTED


### 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** |  Name of the configuration to use.  
Query describing the objects that you want to retrieve.  
**RetrieveOptions** |  Options for the operation.  
**Config Ref** |  ConfigurationProvider |  Name of the configuration used to execute this component.  
**Streaming Strategy** | 
  * Repeatable In Memory Iterable
  * Repeatable File Store Iterable
  * Non-Repeatable Iterable

|  Configures how Mule processes streams. Repeatable streams are the default behavior.  
How long the consumer waits for a response before timing out.  
Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

|  Time unit for the **Amount** field.  
**Target Variable** |  Name of the variable that stores the operation’s output.  
**Target Value** |  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** | 
  *   * Reconnect Forever

|  Retry strategy in case of connectivity errors.  
#### Output
Array of Object  
---  
#### Associated Configurations
  * Configuration


#### Throws
  * SFDC-MARKETING-CLOUD:CONNECTIVITY
  * SFDC-MARKETING-CLOUD:ERROR_RESPONSE
  * SFDC-MARKETING-CLOUD:INVALID_INPUT
  * SFDC-MARKETING-CLOUD:PARSING
  * SFDC-MARKETING-CLOUD:RETRY_EXHAUSTED
|  Configures how Mule processes streams. Repeatable streams are the default behavior.  
How long the consumer waits for a response before timing out.  
Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

|  Time unit for the **Amount** field.  
**Target Variable** |  Name of the variable that stores the operation’s output.  
**Target Value** |  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** | 
  *   * Reconnect Forever

|  Retry strategy in case of connectivity errors.  
#### Output
Array of Object  
---  
#### Associated Configurations
  * Configuration


#### Throws
  * SFDC-MARKETING-CLOUD:CONNECTIVITY
  * SFDC-MARKETING-CLOUD:ERROR_RESPONSE
  * SFDC-MARKETING-CLOUD:INVALID_INPUT
  * SFDC-MARKETING-CLOUD:PARSING
  * SFDC-MARKETING-CLOUD:RETRY_EXHAUSTED


### 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** |  Name of the configuration to use.  
**Object Type** |  Type of object on which to do a schedule.  
**Interactions** |  Array of Object |  Array of one or more interactions in the operation.  
**Schedule Definitions** |  Schedule definition used for the operation.  
**Schedule Options** |  Options for the operation.  
**Config Ref** |  ConfigurationProvider |  Name of the configuration used to execute this component.  
How long the consumer waits for a response before timing out.  
Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

|  Time unit for the **Amount** field.  
**Target Variable** |  Name of the variable that stores the operation’s output.  
**Target Value** |  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** | 
  *   * Reconnect Forever

|  Retry strategy in case of connectivity errors.  
#### Output
Attributes Type  
---  
#### Associated Configurations
  * Configuration


#### Throws
  * SFDC-MARKETING-CLOUD:CONNECTIVITY
  * SFDC-MARKETING-CLOUD:ERROR_RESPONSE
  * SFDC-MARKETING-CLOUD:INVALID_INPUT
  * SFDC-MARKETING-CLOUD:PARSING
  * SFDC-MARKETING-CLOUD:RETRY_EXHAUSTED


### 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** |  Name of the configuration to use.  
**Config Ref** |  ConfigurationProvider |  Name of the configuration used to execute this component.  
#### Associated Configurations
  * Configuration


### 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** |  Name of the configuration to use.  
**Object Type** |  Type of object to update.  
**Api Objects** |  Array of Object |  Array of one or more API objects.  
**UpdateOptions** |  Options for the operation.  
**Config Ref** |  ConfigurationProvider |  Name of the configuration used to execute this component.  
How long the consumer waits for a response before timing out.  
Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

|  Time unit for the **Amount** field.  
**Target Variable** |  Name of the variable that stores the operation’s output.  
**Target Value** |  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** | 
  *   * Reconnect Forever

|  Retry strategy in case of connectivity errors.  
#### Output
Attributes Type  
---  
#### Associated Configurations
  * Configuration


#### Throws
  * SFDC-MARKETING-CLOUD:CONNECTIVITY
  * SFDC-MARKETING-CLOUD:ERROR_RESPONSE
  * SFDC-MARKETING-CLOUD:INVALID_INPUT
  * SFDC-MARKETING-CLOUD:PARSING
  * SFDC-MARKETING-CLOUD:RETRY_EXHAUSTED


### 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** |  Name of the configuration to use.  
**Object Type** |  Type of API object to upsert.  
**Api Objects** |  Array of Object |  Array of one or more API objects.  
**UpsertOptions** |  Options for the operation.  
**Config Ref** |  ConfigurationProvider |  Name of the configuration used to execute this component.  
How long the consumer waits for a response before timing out.  
Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

|  Time unit for the **Amount** field.  
**Target Variable** |  Name of the variable that stores the operation’s output.  
**Target Value** |  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** | 
  *   * Reconnect Forever

|  Retry strategy in case of connectivity errors.  
#### Output
Attributes Type  
---  
#### Associated Configurations
  * Configuration


#### Throws
  * SFDC-MARKETING-CLOUD:CONNECTIVITY
  * SFDC-MARKETING-CLOUD:ERROR_RESPONSE
  * SFDC-MARKETING-CLOUD:INVALID_INPUT
  * SFDC-MARKETING-CLOUD:PARSING
  * SFDC-MARKETING-CLOUD:RETRY_EXHAUSTED


## Object Types
  * Custom Ocsp Responder
  *   * Expiration Policy
  *   * Proxy Configuration
  *   * Reconnect Forever
  *   * Redelivery Policy
  * Redelivery Policy Message Identifier
  * Repeatable File Store Iterable
  * Repeatable In Memory Iterable
  * Standard Revocation Check
  * 

### Crl File
Specifies the location of the certification revocation list (CRL) file.
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
Path to the CRL file.  
### Custom Ocsp Responder
Configures a custom OCSP responder for certification revocation checks.
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
URL of the OCSP responder.  
**Cert Alias** |  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  
---|---|---|---|---  
Enumeration, one of:
  * REDELIVERY_EXHAUSTED
  * TRANSFORMATION
  * EXPRESSION
  * SECURITY
  * CLIENT_SECURITY
  * SERVER_SECURITY
  * ROUTING
  * CONNECTIVITY
  * RETRY_EXHAUSTED
  * TIMEOUT
## Object Types
  * Custom Ocsp Responder
  *   * Expiration Policy
  *   * Proxy Configuration
  *   * Reconnect Forever
  *   * Redelivery Policy
  * Redelivery Policy Message Identifier
  * Repeatable File Store Iterable
  * Repeatable In Memory Iterable
  * Standard Revocation Check
  * 

### Crl File
Specifies the location of the certification revocation list (CRL) file.
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
Path to the CRL file.  
### Custom Ocsp Responder
Configures a custom OCSP responder for certification revocation checks.
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
URL of the OCSP responder.  
**Cert Alias** |  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  
---|---|---|---|---  
Enumeration, one of:
  * REDELIVERY_EXHAUSTED
  * TRANSFORMATION
  * EXPRESSION
  * SECURITY
  * CLIENT_SECURITY
  * SERVER_SECURITY
  * ROUTING
  * CONNECTIVITY
  * RETRY_EXHAUSTED
  * TIMEOUT

|  Source of the error.  
Target of the error.  
### Expiration Policy
Configures an expiration policy strategy.
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
**Max Idle Time** |  Configures the maximum amount of time that a dynamic configuration instance can remain idle before Mule considers it eligible for expiration.  
Enumeration, one of:
  * NANOSECONDS
  * MICROSECONDS
  * MILLISECONDS
  * SECONDS
  * MINUTES
  * HOURS

|  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 to the keystore. Mule resolves the path relative to the current classpath and file system.  
Type of keystore.  
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** |  Password used to protect the private key.  
Password used to protect the keystore.  
Encryption algorithm that the keystore uses.  
### Proxy Configuration
Configures a proxy for outbound connections.
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
Hostname or IP address of the proxy server.  
Port of the proxy server.  
Username to authenticate against the proxy server.  
Password to authenticate against the proxy server.  
**Non Proxy Hosts** |  Comma-separated list of hosts that the proxy must not be used against.  
**Ntlm Domain** |  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  
---|---|---|---|---  
How often to attempt to reconnect, in milliseconds.  
If `false`, the reconnection strategy runs in a separate, non-blocking thread.  
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  
---|---|---|---|---  
How often to attempt to reconnect, in milliseconds.  
If `false`, the reconnection strategy runs in a separate, non-blocking thread.  
### Reconnection
Configures a reconnection strategy for an operation.
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
**Fails Deployment** |  What to do if, when an app is deployed, a connectivity test does not pass after exhausting the associated reconnection strategy:
  * `true` Allow the deployment to fail.
  * `false` Ignore the results of the connectivity test.

  
**Reconnection Strategy** | 
  *   * Reconnect Forever

|  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** |  Maximum number of times that a redelivered request can be processed unsuccessfully before returning a `REDELIVERY_EXHAUSTED` error.  
**Message Digest Algorithm** |  Secure hashing algorithm to use if the **Use Secure Hash** field is `true`. If the payload of the message is a Java object, Mule ignores this value and returns the value that the payload’s `hashCode()` returned.  
**Message Identifier** |  Redelivery Policy 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 `false`.  
**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** |  If `true`, Mule uses a secure hash algorithm to identify a redelivered message.  
**Id Expression** |  One or more expressions that determine when a message was redelivered. You can set this property only if the **Use Secure Hash** field is `false`.  
### Repeatable File Store Iterable
Configures the repeatable file store iterable type.
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
**In Memory Objects** |  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** |  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** |  Amount by which the buffer size expands if it exceeds its initial size. Setting a value of `0` or lower specifies that the buffer can’t expand. A `STREAM_MAXIMUM_SIZE_EXCEEDED` error is raised when the buffer gets full.  
**Max Buffer Size** |  Maximum amount of memory to use. If more than that is used, a `STREAM_MAXIMUM_SIZE_EXCEEDED` error is raised. A value lower than or equal to `0` means no limit.  
### Standard Revocation Check
Configures standard revocation checks for TLS certificates.
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
**Only End Entities** |  Which elements to verify in the certificate chain:
  * `true` Verify only the last element in the certificate chain.
  * `false` Verify all elements in the certificate chain.

  
**Prefer Crls** |  How to check certificate validity:
  * `true` Check the Certification Revocation List (CRL) for certificate validity.
  * `false` Use the Online Certificate Status Protocol (OCSP) to check certificate validity.

  
**No Fallback** |  Whether to use the secondary method to check certificate validity:
  * `true` Use the method that wasn’t specified in the **Prefer Crls** field (the secondary method) to check certificate validity.
  * `false` Do not use the secondary method to check certificate validity.

  
What to do if the revocation server can’t be reached or is busy:
  * `true` Avoid verification failure.
  * `false` Allow the verification to fail.

  
Configures TLS to provide secure communications for the Mule app.
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
**Enabled Protocols** |  Comma-separated list of protocols enabled for this context.  
**Enabled Cipher Suites** |  Comma-separated list of cipher suites enabled for this context.  
**Trust Store** |  Configures the TLS truststore.  
Configures the TLS keystore.  
**Revocation Check** | 
  * Standard Revocation Check
  * Custom Ocsp Responder
**Prefer Crls** |  How to check certificate validity:
  * `true` Check the Certification Revocation List (CRL) for certificate validity.
  * `false` Use the Online Certificate Status Protocol (OCSP) to check certificate validity.

  
**No Fallback** |  Whether to use the secondary method to check certificate validity:
  * `true` Use the method that wasn’t specified in the **Prefer Crls** field (the secondary method) to check certificate validity.
  * `false` Do not use the secondary method to check certificate validity.

  
What to do if the revocation server can’t be reached or is busy:
  * `true` Avoid verification failure.
  * `false` Allow the verification to fail.

  
Configures TLS to provide secure communications for the Mule app.
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
**Enabled Protocols** |  Comma-separated list of protocols enabled for this context.  
**Enabled Cipher Suites** |  Comma-separated list of cipher suites enabled for this context.  
**Trust Store** |  Configures the TLS truststore.  
Configures the TLS keystore.  
**Revocation Check** | 
  * Standard Revocation Check
  * Custom Ocsp Responder

|  Configures a revocation checking mechanism.  
### Trust Store
Configures the truststore for TLS.
Field | Type | Description | Default Value | Required  
---|---|---|---|---  
Path to the truststore. Mule resolves the path relative to the current classpath and file system.  
Password used to protect the truststore.  
Type of truststore.  
Encryption algorithm that the truststore uses.  
If `true`, Mule stops performing certificate validations. Setting this to `true` can make connections vulnerable to attacks.  
## See Also
  * Introduction to Anypoint Connectors
  * MuleSoft Help Center