Skip to main content

Salesforce Marketing Cloud Connector

Salesforce Marketing Cloud 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:

FieldDescription
SubdomainThe Marketing Cloud subdomain (28-character string starting with 'mc'). Found in the API Integration component details.
Client IDThe Client ID from the installed package's API Integration component.
Client SecretThe Client Secret from the installed package's API Integration component.
ScopesSpace-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.

InputCommentsDefault
SubdomainThe Marketing Cloud subdomain (28-character string starting with 'mc'). Found in Setup > Apps > Installed Packages > API Integration component.
ScopesSpace-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 IDClient ID from Setup > Apps > Installed Packages > API Integration component.
Client SecretClient 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:

FieldDescription
SubdomainThe Marketing Cloud subdomain (28-character string starting with 'mc'). Found in the API Integration component details.
Client IDThe Client ID from the installed package's API Integration component.
Client SecretThe Client Secret from the installed package's API Integration component.
ScopesSpace-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.

InputCommentsDefault
SubdomainThe Marketing Cloud subdomain (28-character string starting with 'mc'). Found in Setup > Apps > Installed Packages > API Integration component.
ScopesSpace-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 IDClient ID from Setup > Apps > Installed Packages > API Integration component.
Client SecretClient 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.

InputCommentsDefault
Signature KeyThe 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.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Data Extension KeyThe external key (customer key) of the data extension. Found in the data extension properties.
Batch RowsAn 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.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Asset NameThe display name shown for the asset in Content Builder.
Asset Type IDThe numeric asset type identifier (e.g., 208 for HTML email, 196 for text-only email).
Asset DescriptionOptional description providing details about the asset's purpose and usage.
Category IDThe ID of the Content Builder folder/category for the asset.
ContentThe HTML or text content of the asset.
Extra BodyAdditional properties to include in the asset creation or update request.

Create Automation​

Create a new automation in Automation Studio.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Automation NameThe display name for the automation.
Automation DescriptionA description of the automation.
Extra BodyAdditional properties to include in the automation request body (e.g., steps, schedule).

Create Campaign​

Create a new campaign in Marketing Cloud.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Campaign NameThe display name for the campaign shown in Marketing Cloud.
Campaign DescriptionOptional description providing details about the campaign's purpose and content.
Campaign CodeAn optional campaign code for tracking.
ColorThe display color for the campaign in the Marketing Cloud UI (hex format).
Extra BodyAdditional properties to include in the campaign request body.

Create Category​

Create a new Content Builder category (folder).

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Category NameThe display name for the Content Builder folder/category.
Parent Category IDThe ID of the parent category. Omit to create a top-level category.

Create Contact​

Create a new contact in Marketing Cloud.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Contact KeyThe unique identifier (subscriber key) for the contact in Marketing Cloud.
Attribute SetsAn 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.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Data Extension NameThe display name for the data extension.
Data Extension KeyA unique external key for the data extension. Used to reference it in API calls.
FieldsAn array of field definitions for the data extension. Each field must include name and fieldType.
Is SendableWhether 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.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Definition KeyThe unique key identifying the transactional email definition.
Definition NameThe display name for the transactional email definition.
Content Customer KeyThe customer key of the Content Builder asset to use as email content.
Definition DescriptionA description of the transactional email definition.
Extra BodyAdditional properties to include in the email definition creation request.

Create ENS Callback​

Register a new Event Notification Service (ENS) callback endpoint.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Callback NameA descriptive name for the ENS callback endpoint registration.
Callback URLThe URL where Marketing Cloud will send event notifications.
Max Batch SizeThe 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.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Subscription NameA descriptive name for the ENS event subscription.
Callback IDThe unique identifier of the ENS callback registration.
Event TypesThe event types to subscribe to. Select one or more Marketing Cloud event categories.

Create Journey​

Create a new journey (interaction) in Marketing Cloud.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Journey KeyThe customer key as a GUID (UUID) to be used while referencing this journey.
Journey NameThe name of this journey.
Journey DescriptionA description of this journey.
Workflow API VersionThe Journey Spec version to use for this journey. Possible values: 0.5, 1.0.1.0
Extra BodyAdditional properties to include in the request body.

Create SMS Definition​

Create a new transactional SMS send definition.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Definition KeyThe unique key identifying the transactional SMS definition.
Definition NameThe display name for the transactional SMS definition.
Definition DescriptionA description of the transactional SMS definition.
Extra BodyAdditional properties to include in the SMS definition creation request.

Delete Asset​

Delete a Content Builder asset by ID.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Asset IDThe unique identifier for the Content Builder asset in Marketing Cloud.

Delete Campaign​

Delete a campaign by ID.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Campaign IDThe unique identifier for the campaign in Marketing Cloud.

Delete Category​

Delete a Content Builder category (folder) by ID.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Category IDThe 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.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Contact KeysOne 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.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Definition KeyThe unique key identifying the transactional email definition.

Delete ENS Callback​

Delete an ENS callback endpoint registration.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Callback IDThe unique identifier of the ENS callback registration.

Delete ENS Subscription​

Delete an ENS event subscription.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Subscription IDThe 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.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Journey IDThe 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.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Definition KeyThe unique key identifying the transactional SMS definition.

Execute Automation Activities​

Execute automation activities by running all activities once.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Automation IDThe 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.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Contact KeyThe contact key of the contact to exit from the journey.
Definition KeyCustomer Key that uniquely identifies the journey. This key is the same for all versions of the journey.
VersionsOne 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.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Event Definition KeyThe event definition key for the journey entry event. Found in the journey's entry source configuration.
Contact KeyThe contact key (subscriber key) of the contact entering the journey.
Event DataAdditional data to pass to the journey entry event as key-value pairs.

Get Asset​

Retrieve a Content Builder asset by ID.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Asset IDThe unique identifier for the Content Builder asset in Marketing Cloud.

Get Automation​

Retrieve an Automation Studio automation by ID.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Automation IDThe unique identifier for the automation in Marketing Cloud.

Get Campaign​

Retrieve a campaign by ID.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Campaign IDThe unique identifier for the campaign in Marketing Cloud.

Get Category​

Retrieve a single Content Builder category (folder) by its ID.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Category IDThe unique identifier of the Content Builder category (folder).

Get Contact​

Retrieve a contact by contact key.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Contact KeyThe unique identifier (subscriber key) for the contact in Marketing Cloud.

Get Contact Schema​

Retrieve the contact schema definition, including attribute sets and field definitions.

InputCommentsDefault
ConnectionThe 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.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Data Extension IDThe unique ID of the data extension.

Get Email Definition​

Retrieve a transactional email send definition by key.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Definition KeyThe unique key identifying the transactional email definition.

Get Email Send Status​

Retrieve the delivery status of a sent transactional email.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Message KeyThe message key returned from a send email request.

Get ENS Subscription​

Retrieve an Event Notification Service (ENS) subscription by ID.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Subscription IDThe unique identifier of the ENS event subscription.

Get Journey​

Retrieve a journey (interaction) by ID.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Journey IDThe unique identifier of the journey (interaction).
VersionThe version number of the journey. Defaults to the latest version.

Get SMS Definition​

Retrieve a transactional SMS send definition by key.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Definition KeyThe unique key identifying the transactional SMS definition.

List Assets​

List Content Builder assets with optional pagination.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Fetch AllWhen true, automatically fetches all pages of results using pagination.false
Page SizeThe 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.
PageThe page number to retrieve (starts at 1).

List Automations​

List Automation Studio automations with optional pagination.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Fetch AllWhen true, automatically fetches all pages of results using pagination.false
Page SizeThe 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.
PageThe page number to retrieve (starts at 1).

List Campaigns​

List campaigns with optional pagination.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Fetch AllWhen true, automatically fetches all pages of results using pagination.false
Page SizeThe 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.
PageThe page number to retrieve (starts at 1).

List Categories​

List Content Builder categories (folders).

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Fetch AllWhen true, automatically fetches all pages of results using pagination.false
Page SizeThe 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.
PageThe page number to retrieve (starts at 1).

List Data Extensions​

Retrieve a list of data extensions that match a search string, with optional pagination.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Search StringA string to search for in the name of the custom object.
Fetch AllWhen true, automatically fetches all pages of results using pagination.false
Page SizeThe 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.
PageThe page number to retrieve (starts at 1).

List Email Definitions​

List transactional email send definitions with optional pagination.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Fetch AllWhen true, automatically fetches all pages of results using pagination.false
Page SizeThe 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.
PageThe page number to retrieve (starts at 1).

List ENS Callbacks​

List registered Event Notification Service (ENS) callback endpoints.

InputCommentsDefault
ConnectionThe 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.

InputCommentsDefault
ConnectionThe 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.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
StatusFilter journeys by status.
Name FilterFilter journeys by name (partial match).
Fetch AllWhen true, automatically fetches all pages of results using pagination.false
Page SizeThe 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.
PageThe page number to retrieve (starts at 1).

List SMS Definitions​

List transactional SMS send definitions with optional pagination.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Fetch AllWhen true, automatically fetches all pages of results using pagination.false
Page SizeThe 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.
PageThe page number to retrieve (starts at 1).

Query Assets​

Search Content Builder assets using the query API with filters and sorting.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
QueryA query filter object for searching assets. Uses the Content Builder query syntax.
FieldsComma-separated list of fields to include in the response. Reduces payload size.
Page SizeThe 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.
PageThe page number to retrieve (starts at 1).

Raw Request​

Send a raw HTTP request to the Salesforce Marketing Cloud REST API.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
URLInput 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.
MethodThe HTTP method to use.
DataThe HTTP body payload to send to the URL.
Form DataThe Form Data to be sent as a multipart form upload.
File DataFile Data to be sent as a multipart form upload.
File Data File NamesFile names to apply to the file data inputs. Keys must match the file data keys above.
Query ParameterA 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.
HeaderA list of headers to send with the request.
Response TypeThe type of data you expect in the response. You can request json, text, or binary data.json
TimeoutThe 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 ErrorsIf 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 CountThe maximum number of retries to attempt. Specify 0 for no retries.0
Use Exponential BackoffSpecifies 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.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Search FilterA filter object to search contacts. Uses the Marketing Cloud Contacts search syntax.

Search Contacts by Email​

Search for contacts by email address.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Email AddressThe email address associated with the contact.

Send Email​

Send a transactional email to a single recipient using a send definition.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Message KeyThe unique identifier of the email definition you want to send.
Definition KeyThe unique key identifying the transactional email definition.
Recipient Contact KeyThe contact key (subscriber key) of the email recipient.
Recipient EmailThe email address to send to.
Recipient AttributesKey-value pairs of personalization attributes for the email template.

Send Email Batch​

Send a transactional email to multiple recipients in a single batch request.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Definition KeyThe unique key identifying the transactional email definition.
RecipientsAn 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.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Message KeyA unique identifier that you can use to track the status of the message. The key can contain up to 100 characters.
Definition KeyThe unique key identifying the transactional SMS definition.
Recipient Contact KeyThe contact key (subscriber key) of the SMS recipient.
Recipient PhoneThe phone number to send the SMS to, including country code (e.g., +15551234567).
Recipient AttributesKey-value pairs of personalization attributes for the SMS.

Send SMS Batch​

Send a transactional SMS to multiple recipients in a single batch request.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Definition KeyThe unique key identifying the transactional SMS definition.
RecipientsAn array of recipient objects for batch SMS sending. Each must include contactKey and to (phone number).

Update Asset​

Update an existing Content Builder asset.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Asset IDThe unique identifier for the Content Builder asset in Marketing Cloud.
Asset NameThe display name shown for the asset in Content Builder.
Asset DescriptionOptional description providing details about the asset's purpose and usage.
Category IDThe ID of the Content Builder folder/category for the asset.
ContentThe HTML or text content of the asset.
Extra BodyAdditional 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.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Automation IDThe unique identifier for the automation in Marketing Cloud.
Extra BodyA 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.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Category IDThe unique identifier of the Content Builder category (folder).
Category NameThe display name for the Content Builder folder/category.
Parent Category IDThe ID of the parent category. Omit to create a top-level category.

Update Contact​

Update an existing contact's attributes in Marketing Cloud.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Contact KeyThe unique identifier (subscriber key) for the contact in Marketing Cloud.
Attribute SetsAn 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.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Definition KeyThe unique key identifying the transactional email definition.
Definition NameThe display name for the transactional email definition.
Definition DescriptionA description of the transactional email definition.
Extra BodyAdditional 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.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Callback IDThe unique identifier of the ENS callback registration.
Callback NameA descriptive name for the ENS callback endpoint registration.
Callback URLThe updated URL where Marketing Cloud will send event notifications.
Max Batch SizeThe 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.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Subscription IDThe unique identifier of the ENS event subscription.
Subscription NameA descriptive name for the ENS event subscription.
Event TypesThe 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.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Journey IDThe unique identifier of the journey (interaction).
Journey KeyThe customer key as a GUID (UUID) to be used while referencing this journey.
Workflow API VersionThe Journey Spec version to use for this journey. Possible values: 0.5, 1.0.1.0
VersionThe version of this journey.
Extra BodyAdditional 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.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Definition KeyThe unique key identifying the transactional SMS definition.
Definition NameThe display name for the transactional SMS definition.
Definition DescriptionA description of the transactional SMS definition.
Extra BodyAdditional 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.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Data Extension KeyThe external key (customer key) of the data extension. Found in the data extension properties.
Primary KeysA JSON object of primary key column name/value pairs that identify the row.
Row DataA 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.

InputCommentsDefault
ConnectionThe Salesforce Marketing Cloud OAuth connection (Authorization Code for user context or Client Credentials for server-to-server).
Callback IDThe unique identifier of the ENS callback registration.
Verification KeyThe verification key sent to the callback URL during registration. Must be returned to verify ownership.