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.