We're currently building and refining our Knowledge Center. You may encounter layout issues, styling inconsistencies, or minor technical quirks as we finalize the platform.

Salesforce Marketing Cloud Connector

Prev Next
Note on third-party tools

We aim to provide accurate and helpful details about third-party tools, but we can't guarantee that this information is always complete or up to date. If you notice any discrepancies, feel free to share them in the feedback section below. For the most reliable information, please always refer to the third-party tool's official documentation.

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

  1. In Marketing Cloud, navigate to Setup > Apps > Installed Packages
  2. Create a new package or select an existing one
  3. Add an API Integration component with the Web App integration type
  4. 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

  1. In Marketing Cloud, navigate to Setup > Apps > Installed Packages
  2. Create a new package or select an existing one
  3. Add an API Integration component with the Server-to-Server integration type
  4. 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.