Salesforce Marketing Cloud Connector
Salesforce Marketing Cloud is a digital marketing platform for managing customer journeys, email campaigns, SMS messaging, and marketing automation.
This component enables integration with the Marketing Cloud REST API for managing assets, contacts, journeys, campaigns, transactional messaging, data extensions, automations, and event notifications.
API Documentation
This component was built using the Salesforce Marketing Cloud REST API Documentation
Connections
OAuth 2.0
Authenticate using OAuth 2.0 Authorization Code flow with refresh tokens.
This connection uses the OAuth 2.0 Authorization Code flow to authenticate with Salesforce Marketing Cloud. It is designed for user-context integrations and supports refresh tokens for persistent access.
Prerequisites
- In Marketing Cloud, navigate to Setup > Apps > Installed Packages
- Create a new package or select an existing one
- Add an API Integration component with the Web App integration type
- Note the Client ID, Client Secret, and the Subdomain
Configure the Connection
Create a connection of type OAuth 2.0 and enter:
| Field | Description |
|---|---|
| Subdomain | The Marketing Cloud subdomain (28-character string starting with 'mc'). Found in the API Integration component details. |
| Client ID | The Client ID from the installed package's API Integration component. |
| Client Secret | The Client Secret from the installed package's API Integration component. |
| Scopes | Space-separated OAuth scopes. Include offline to enable persistent refresh tokens. |
This connection uses OAuth 2.0, a common authentication mechanism for integrations. Read about how OAuth 2.0 works here.
| Input | Comments | Default |
|---|---|---|
| Subdomain | The Marketing Cloud subdomain (28-character string starting with 'mc'). Found in Setup > Apps > Installed Packages > API Integration component. | |
| Scopes | Space-separated OAuth 2.0 permission scopes. Include 'offline' to enable persistent refresh tokens. Remove scopes for features you do not use. | offline documents_and_images_read documents_and_images_write saved_content_write list_and_subscribers_read list_and_subscribers_write journeys_read campaign_read campaign_write data_extensions_read data_extensions_write automations_read email_read email_write email_send sms_read sms_write sms_send event_notification_callback_create event_notification_callback_read event_notification_callback_update event_notification_callback_delete event_notification_subscription_create event_notification_subscription_read event_notification_subscription_update event_notification_subscription_delete |
| Client ID | Client ID from Setup > Apps > Installed Packages > API Integration component. | |
| Client Secret | Client Secret from Setup > Apps > Installed Packages > API Integration component. |
OAuth 2.0 Client Credentials
Authenticate using OAuth 2.0 Client Credentials for server-to-server integrations.
This connection uses the OAuth 2.0 Client Credentials flow for server-to-server integrations with Salesforce Marketing Cloud. No user interaction is required.
Prerequisites
- In Marketing Cloud, navigate to Setup > Apps > Installed Packages
- Create a new package or select an existing one
- Add an API Integration component with the Server-to-Server integration type
- Note the Client ID, Client Secret, and the Subdomain
Configure the Connection
Create a connection of type OAuth 2.0 Client Credentials and enter:
| Field | Description |
|---|---|
| Subdomain | The Marketing Cloud subdomain (28-character string starting with 'mc'). Found in the API Integration component details. |
| Client ID | The Client ID from the installed package's API Integration component. |
| Client Secret | The Client Secret from the installed package's API Integration component. |
| Scopes | Space-separated OAuth scopes. Maximum 125 characters. |
This connection uses OAuth 2.0, a common authentication mechanism for integrations. Read about how OAuth 2.0 works here.
| Input | Comments | Default |
|---|---|---|
| Subdomain | The Marketing Cloud subdomain (28-character string starting with 'mc'). Found in Setup > Apps > Installed Packages > API Integration component. | |
| Scopes | Space-separated OAuth 2.0 permission scopes. Remove scopes for features you do not use. | documents_and_images_read documents_and_images_write saved_content_write list_and_subscribers_read list_and_subscribers_write journeys_read campaign_read campaign_write data_extensions_read data_extensions_write automations_read email_read email_write email_send sms_read sms_write sms_send event_notification_callback_create event_notification_callback_read event_notification_callback_update event_notification_callback_delete event_notification_subscription_create event_notification_subscription_read event_notification_subscription_update event_notification_subscription_delete |
| Client ID | Client ID from Setup > Apps > Installed Packages > API Integration component. | |
| Client Secret | Client Secret from Setup > Apps > Installed Packages > API Integration component. |
Triggers
ENS Webhook
Receive event notifications from Salesforce Marketing Cloud Event Notification Service (ENS). Requires manual setup of ENS callback and subscription using the provided actions.
| Input | Comments | Default |
|---|---|---|
| Signature Key | The base64-encoded signature key provided when creating the ENS callback. Copy this value exactly as returned by Salesforce. Used to validate webhook signatures for security. |
Actions
Async Upsert Data Extension Rows
Asynchronously insert or update multiple rows in a data extension.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Data Extension Key | The external key (customer key) of the data extension. Found in the data extension properties. | |
| Batch Rows | An array of row objects to upsert asynchronously. Each object's keys should match data extension column names. |
Create Asset
Create a new Content Builder asset.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Asset Name | The display name shown for the asset in Content Builder. | |
| Asset Type ID | The numeric asset type identifier (e.g., 208 for HTML email, 196 for text-only email). | |
| Asset Description | Optional description providing details about the asset's purpose and usage. | |
| Category ID | The ID of the Content Builder folder/category for the asset. | |
| Content | The HTML or text content of the asset. | |
| Extra Body | Additional properties to include in the asset creation or update request. |
Create Automation
Create a new automation in Automation Studio.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Automation Name | The display name for the automation. | |
| Automation Description | A description of the automation. | |
| Extra Body | Additional properties to include in the automation request body (e.g., steps, schedule). |
Create Campaign
Create a new campaign in Marketing Cloud.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Campaign Name | The display name for the campaign shown in Marketing Cloud. | |
| Campaign Description | Optional description providing details about the campaign's purpose and content. | |
| Campaign Code | An optional campaign code for tracking. | |
| Color | The display color for the campaign in the Marketing Cloud UI (hex format). | |
| Extra Body | Additional properties to include in the campaign request body. |
Create Category
Create a new Content Builder category (folder).
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Category Name | The display name for the Content Builder folder/category. | |
| Parent Category ID | The ID of the parent category. Omit to create a top-level category. |
Create Contact
Create a new contact in Marketing Cloud.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Contact Key | The unique identifier (subscriber key) for the contact in Marketing Cloud. | |
| Attribute Sets | An array of attribute set objects containing contact data to create or update. |
Create Data Extension
Create a new data extension with the specified fields and configuration.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Data Extension Name | The display name for the data extension. | |
| Data Extension Key | A unique external key for the data extension. Used to reference it in API calls. | |
| Fields | An array of field definitions for the data extension. Each field must include name and fieldType. | |
| Is Sendable | Whether this data extension can be used as a sendable data source for email sends. | false |
Create Email Definition
Create a new transactional email send definition.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Definition Key | The unique key identifying the transactional email definition. | |
| Definition Name | The display name for the transactional email definition. | |
| Content Customer Key | The customer key of the Content Builder asset to use as email content. | |
| Definition Description | A description of the transactional email definition. | |
| Extra Body | Additional properties to include in the email definition creation request. |
Create ENS Callback
Register a new Event Notification Service (ENS) callback endpoint.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Callback Name | A descriptive name for the ENS callback endpoint registration. | |
| Callback URL | The URL where Marketing Cloud will send event notifications. | |
| Max Batch Size | The maximum number of events to include in a single callback batch (1-100). Defaults to 100. |
Create ENS Subscription
Create a new Event Notification Service (ENS) subscription for specific event types.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Subscription Name | A descriptive name for the ENS event subscription. | |
| Callback ID | The unique identifier of the ENS callback registration. | |
| Event Types | The event types to subscribe to. Select one or more Marketing Cloud event categories. |
Create Journey
Create a new journey (interaction) in Marketing Cloud.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Journey Key | The customer key as a GUID (UUID) to be used while referencing this journey. | |
| Journey Name | The name of this journey. | |
| Journey Description | A description of this journey. | |
| Workflow API Version | The Journey Spec version to use for this journey. Possible values: 0.5, 1.0. | 1.0 |
| Extra Body | Additional properties to include in the request body. |
Create SMS Definition
Create a new transactional SMS send definition.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Definition Key | The unique key identifying the transactional SMS definition. | |
| Definition Name | The display name for the transactional SMS definition. | |
| Definition Description | A description of the transactional SMS definition. | |
| Extra Body | Additional properties to include in the SMS definition creation request. |
Delete Asset
Delete a Content Builder asset by ID.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Asset ID | The unique identifier for the Content Builder asset in Marketing Cloud. |
Delete Campaign
Delete a campaign by ID.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Campaign ID | The unique identifier for the campaign in Marketing Cloud. |
Delete Category
Delete a Content Builder category (folder) by ID.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Category ID | The unique identifier of the Content Builder category (folder). |
Delete Contact
Delete one or more contacts by contact key. This operation is asynchronous and may take time to complete. Returns an operation ID for status tracking.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Contact Keys | One or more contact keys (subscriber keys) to delete. Deletion is asynchronous and may take time to complete. |
Delete Email Definition
Delete a transactional email send definition by key. Deleted definitions are archived and cannot be restored.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Definition Key | The unique key identifying the transactional email definition. |
Delete ENS Callback
Delete an ENS callback endpoint registration.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Callback ID | The unique identifier of the ENS callback registration. |
Delete ENS Subscription
Delete an ENS event subscription.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Subscription ID | The unique identifier of the ENS event subscription. |
Delete Journey
Delete a journey (interaction) by ID. Deletes all versions of the journey. This action cannot be undone.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Journey ID | The unique identifier of the journey (interaction). |
Delete SMS Definition
Delete a transactional SMS send definition by key. Deleted definitions are archived and the key can be reused.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Definition Key | The unique key identifying the transactional SMS definition. |
Execute Automation Activities
Execute automation activities by running all activities once.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Automation ID | The unique identifier for the automation in Marketing Cloud. |
Exit Contact from Journey
Remove a contact from a running journey by contact key and definition key. Can remove from specific versions or all versions.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Contact Key | The contact key of the contact to exit from the journey. | |
| Definition Key | Customer Key that uniquely identifies the journey. This key is the same for all versions of the journey. | |
| Versions | One or more versions of a journey from which to remove a contact. Comma-separated list (e.g., '1,2,3'). If not specified, removes from all versions. |
Fire Entry Event
Fire a journey entry event to inject a contact into a journey.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Event Definition Key | The event definition key for the journey entry event. Found in the journey's entry source configuration. | |
| Contact Key | The contact key (subscriber key) of the contact entering the journey. | |
| Event Data | Additional data to pass to the journey entry event as key-value pairs. |
Get Asset
Retrieve a Content Builder asset by ID.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Asset ID | The unique identifier for the Content Builder asset in Marketing Cloud. |
Get Automation
Retrieve an Automation Studio automation by ID.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Automation ID | The unique identifier for the automation in Marketing Cloud. |
Get Campaign
Retrieve a campaign by ID.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Campaign ID | The unique identifier for the campaign in Marketing Cloud. |
Get Category
Retrieve a single Content Builder category (folder) by its ID.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Category ID | The unique identifier of the Content Builder category (folder). |
Get Contact
Retrieve a contact by contact key.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Contact Key | The unique identifier (subscriber key) for the contact in Marketing Cloud. |
Get Contact Schema
Retrieve the contact schema definition, including attribute sets and field definitions.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). |
Get Data Extension Fields
Retrieve a list of fields in a data extension.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Data Extension ID | The unique ID of the data extension. |
Get Email Definition
Retrieve a transactional email send definition by key.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Definition Key | The unique key identifying the transactional email definition. |
Get Email Send Status
Retrieve the delivery status of a sent transactional email.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Message Key | The message key returned from a send email request. |
Get ENS Subscription
Retrieve an Event Notification Service (ENS) subscription by ID.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Subscription ID | The unique identifier of the ENS event subscription. |
Get Journey
Retrieve a journey (interaction) by ID.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Journey ID | The unique identifier of the journey (interaction). | |
| Version | The version number of the journey. Defaults to the latest version. |
Get SMS Definition
Retrieve a transactional SMS send definition by key.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Definition Key | The unique key identifying the transactional SMS definition. |
List Assets
List Content Builder assets with optional pagination.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Fetch All | When true, automatically fetches all pages of results using pagination. | false |
| Page Size | The maximum number of results returned per page. The allowed maximum depends on the endpoint. A Page value must be provided for this parameter to take effect. | |
| Page | The page number to retrieve (starts at 1). |
List Automations
List Automation Studio automations with optional pagination.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Fetch All | When true, automatically fetches all pages of results using pagination. | false |
| Page Size | The maximum number of results returned per page. The allowed maximum depends on the endpoint. A Page value must be provided for this parameter to take effect. | |
| Page | The page number to retrieve (starts at 1). |
List Campaigns
List campaigns with optional pagination.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Fetch All | When true, automatically fetches all pages of results using pagination. | false |
| Page Size | The maximum number of results returned per page. The allowed maximum depends on the endpoint. A Page value must be provided for this parameter to take effect. | |
| Page | The page number to retrieve (starts at 1). |
List Categories
List Content Builder categories (folders).
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Fetch All | When true, automatically fetches all pages of results using pagination. | false |
| Page Size | The maximum number of results returned per page. The allowed maximum depends on the endpoint. A Page value must be provided for this parameter to take effect. | |
| Page | The page number to retrieve (starts at 1). |
List Data Extensions
Retrieve a list of data extensions that match a search string, with optional pagination.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Search String | A string to search for in the name of the custom object. | |
| Fetch All | When true, automatically fetches all pages of results using pagination. | false |
| Page Size | The maximum number of results returned per page. The allowed maximum depends on the endpoint. A Page value must be provided for this parameter to take effect. | |
| Page | The page number to retrieve (starts at 1). |
List Email Definitions
List transactional email send definitions with optional pagination.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Fetch All | When true, automatically fetches all pages of results using pagination. | false |
| Page Size | The maximum number of results returned per page. The allowed maximum depends on the endpoint. A Page value must be provided for this parameter to take effect. | |
| Page | The page number to retrieve (starts at 1). |
List ENS Callbacks
List registered Event Notification Service (ENS) callback endpoints.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). |
List ENS Subscriptions
List Event Notification Service (ENS) event subscriptions.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). |
List Journeys
List journeys (interactions) with optional filtering.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Status | Filter journeys by status. | |
| Name Filter | Filter journeys by name (partial match). | |
| Fetch All | When true, automatically fetches all pages of results using pagination. | false |
| Page Size | The maximum number of results returned per page. The allowed maximum depends on the endpoint. A Page value must be provided for this parameter to take effect. | |
| Page | The page number to retrieve (starts at 1). |
List SMS Definitions
List transactional SMS send definitions with optional pagination.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Fetch All | When true, automatically fetches all pages of results using pagination. | false |
| Page Size | The maximum number of results returned per page. The allowed maximum depends on the endpoint. A Page value must be provided for this parameter to take effect. | |
| Page | The page number to retrieve (starts at 1). |
Query Assets
Search Content Builder assets using the query API with filters and sorting.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Query | A query filter object for searching assets. Uses the Content Builder query syntax. | |
| Fields | Comma-separated list of fields to include in the response. Reduces payload size. | |
| Page Size | The maximum number of results returned per page. The allowed maximum depends on the endpoint. A Page value must be provided for this parameter to take effect. | |
| Page | The page number to retrieve (starts at 1). |
Raw Request
Send a raw HTTP request to the Salesforce Marketing Cloud REST API.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| URL | Input the path only (/interaction/v1/interactions). The base URL is already included (https://{your_subdomain}.rest.marketingcloudapis.com/). For example, to connect to https://{your_subdomain}.rest.marketingcloudapis.com//interaction/v1/interactions, only /interaction/v1/interactions is entered in this field. | |
| Method | The HTTP method to use. | |
| Data | The HTTP body payload to send to the URL. | |
| Form Data | The Form Data to be sent as a multipart form upload. | |
| File Data | File Data to be sent as a multipart form upload. | |
| File Data File Names | File names to apply to the file data inputs. Keys must match the file data keys above. | |
| Query Parameter | A list of query parameters to send with the request. This is the portion at the end of the URL similar to ?key1=value1&key2=value2. | |
| Header | A list of headers to send with the request. | |
| Response Type | The type of data you expect in the response. You can request json, text, or binary data. | json |
| Timeout | The maximum time that a client will await a response to its request | |
| Retry Delay (ms) | The delay in milliseconds between retries. This is used when 'Use Exponential Backoff' is disabled. | 0 |
| Retry On All Errors | If true, retries on all erroneous responses regardless of type. This is helpful when retrying after HTTP 429 or other 3xx or 4xx errors. Otherwise, only retries on HTTP 5xx and network errors. | false |
| Max Retry Count | The maximum number of retries to attempt. Specify 0 for no retries. | 0 |
| Use Exponential Backoff | Specifies whether to use a pre-defined exponential backoff strategy for retries. When enabled, 'Retry Delay (ms)' is ignored. | false |
Search Contacts
Search contacts using filter criteria.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Search Filter | A filter object to search contacts. Uses the Marketing Cloud Contacts search syntax. |
Search Contacts by Email
Search for contacts by email address.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Email Address | The email address associated with the contact. |
Send Email
Send a transactional email to a single recipient using a send definition.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Message Key | The unique identifier of the email definition you want to send. | |
| Definition Key | The unique key identifying the transactional email definition. | |
| Recipient Contact Key | The contact key (subscriber key) of the email recipient. | |
| Recipient Email | The email address to send to. | |
| Recipient Attributes | Key-value pairs of personalization attributes for the email template. |
Send Email Batch
Send a transactional email to multiple recipients in a single batch request.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Definition Key | The unique key identifying the transactional email definition. | |
| Recipients | An array of recipient objects for batch email sending. Each must include contactKey and to. |
Send SMS
Send a transactional SMS to a single recipient using a send definition.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Message Key | A unique identifier that you can use to track the status of the message. The key can contain up to 100 characters. | |
| Definition Key | The unique key identifying the transactional SMS definition. | |
| Recipient Contact Key | The contact key (subscriber key) of the SMS recipient. | |
| Recipient Phone | The phone number to send the SMS to, including country code (e.g., +15551234567). | |
| Recipient Attributes | Key-value pairs of personalization attributes for the SMS. |
Send SMS Batch
Send a transactional SMS to multiple recipients in a single batch request.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Definition Key | The unique key identifying the transactional SMS definition. | |
| Recipients | An array of recipient objects for batch SMS sending. Each must include contactKey and to (phone number). |
Update Asset
Update an existing Content Builder asset.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Asset ID | The unique identifier for the Content Builder asset in Marketing Cloud. | |
| Asset Name | The display name shown for the asset in Content Builder. | |
| Asset Description | Optional description providing details about the asset's purpose and usage. | |
| Category ID | The ID of the Content Builder folder/category for the asset. | |
| Content | The HTML or text content of the asset. | |
| Extra Body | Additional properties to include in the asset creation or update request. |
Update Automation
Update an automation by ID. Use this to modify properties like name, description, or toggle isActive to pause/resume a scheduled automation.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Automation ID | The unique identifier for the automation in Marketing Cloud. | |
| Extra Body | A JSON object of properties to update on the automation (e.g., name, description, isActive, steps, schedule). |
Update Category
Update a Content Builder category (folder) by ID. Provide only the fields you want to change.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Category ID | The unique identifier of the Content Builder category (folder). | |
| Category Name | The display name for the Content Builder folder/category. | |
| Parent Category ID | The ID of the parent category. Omit to create a top-level category. |
Update Contact
Update an existing contact's attributes in Marketing Cloud.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Contact Key | The unique identifier (subscriber key) for the contact in Marketing Cloud. | |
| Attribute Sets | An array of attribute set objects containing contact data to create or update. |
Update Email Definition
Update a transactional email send definition by key. Changes are applied automatically.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Definition Key | The unique key identifying the transactional email definition. | |
| Definition Name | The display name for the transactional email definition. | |
| Definition Description | A description of the transactional email definition. | |
| Extra Body | Additional properties to include in the email definition creation request. |
Update ENS Callback
Update an Event Notification Service (ENS) callback endpoint. Changes may take up to 2 minutes to become active.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Callback ID | The unique identifier of the ENS callback registration. | |
| Callback Name | A descriptive name for the ENS callback endpoint registration. | |
| Callback URL | The updated URL where Marketing Cloud will send event notifications. | |
| Max Batch Size | The updated maximum number of events to include in a single callback batch (1-100). |
Update ENS Subscription
Update an Event Notification Service (ENS) subscription. Can modify the subscription name, event types, or status.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Subscription ID | The unique identifier of the ENS event subscription. | |
| Subscription Name | A descriptive name for the ENS event subscription. | |
| Event Types | The event types to subscribe to. Select one or more Marketing Cloud event categories. |
Update Journey
Update an existing journey (interaction). This operation requires the full journey definition and replaces the existing configuration. Partial updates are not supported.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Journey ID | The unique identifier of the journey (interaction). | |
| Journey Key | The customer key as a GUID (UUID) to be used while referencing this journey. | |
| Workflow API Version | The Journey Spec version to use for this journey. Possible values: 0.5, 1.0. | 1.0 |
| Version | The version of this journey. | |
| Extra Body | Additional properties to include in the request body. |
Update SMS Definition
Update a transactional SMS send definition by key. Changes may take up to two minutes to reflect in outbound messages.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Definition Key | The unique key identifying the transactional SMS definition. | |
| Definition Name | The display name for the transactional SMS definition. | |
| Definition Description | A description of the transactional SMS definition. | |
| Extra Body | Additional properties to include in the SMS definition creation request. |
Upsert Data Extension Row
Insert or update a single row in a data extension by primary key.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Data Extension Key | The external key (customer key) of the data extension. Found in the data extension properties. | |
| Primary Keys | A JSON object of primary key column name/value pairs that identify the row. | |
| Row Data | A JSON object representing the row to upsert. Keys should match data extension column names. |
Verify ENS Callback
Verify ownership of an ENS callback endpoint using the verification key.
| Input | Comments | Default |
|---|---|---|
| Connection | The Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server). | |
| Callback ID | The unique identifier of the ENS callback registration. | |
| Verification Key | The verification key sent to the callback URL during registration. Must be returned to verify ownership. |