Skip to main content

Salesforce Marketing Cloud

Manage data extensions, journeys, Content Builder assets, transactional email, contacts, campaigns, and automations in Salesforce Marketing Cloud Engagement.

What you can ask​

  • Find the contact record for alice@acme.com and list the data extensions she appears in.
  • Upsert this week's webinar registrants into the Webinar Attendees data extension.
  • Run the Nightly Lead Sync automation and confirm it completed.

Set up​

Salesforce Marketing Cloud connects with credentials from your Salesforce Marketing Cloud account. Have these values ready:

  • Subdomain
  • Business unit MID (optional)
  • Client ID
  • Client secret
  1. Go to Organization > Connectors and find Salesforce Marketing Cloud.
  2. Click Enable and choose which tools to allow.
  3. Each member enters their own values the first time they use it.

To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.

Tools​

Salesforce Marketing Cloud offers 71 tools. Admins choose which ones agents can use. See Tool permission groups.

Read (32)​

View and search information without changing it.

ToolWhat it does
get_assetGet one Content Builder asset by ID, including its full content, views, data, and meta.
get_async_request_resultsGet per-row results (status, errorCode, message) of a completed asynchronous data request, with page-number pagination.
get_async_request_statusGet the processing status of an asynchronous data request (requestStatus, resultStatus, hasErrors).
get_automationGet one automation by ID, including its schedule, status, and steps with their activities.
get_campaignGet one campaign by ID.
get_contact_delete_statusGet the status of a contact delete operation started by delete_contacts.
get_data_extensionGet one data extension's properties (name, key, folder, sendable settings, row count) by ID.
get_data_extension_rowsRead rows from a data extension by external key or ID (exactly one), with page-number pagination (page_size up to 2500), a filter like "Email eq 'a@b.com'", order_by, and a fields column mask.
get_email_message_statusGet the send status of one transactional email message by message key (e.g. 'TransactionalSendEvents.EmailSent').
get_email_send_definitionGet one transactional email send definition by its definition key, including its email asset, subscription settings, and options.
get_event_definitionGet one event definition by event_definition_id or key (exactly one).
get_journeyGet a journey's full definition (triggers, activities, goals, exits) by journey_id or key (exactly one).
get_journey_audit_logGet a journey's audit log (who created, modified, published, unpublished, or deleted it), optionally filtered by action.
get_journey_exit_statusCheck whether contacts removed with remove_contacts_from_journey have exited.
get_journey_publish_statusCheck the progress of a publish_journey request by its status_id.
list_asset_categoriesList Content Builder categories (folders) with optional $filter (e.g. 'parentId eq 516016'), $orderBy, and scope ('Shared').
list_assetsList Content Builder assets (emails, content blocks, images, templates) with an optional simple $filter (e.g. "assetType.name eq 'htmlemail'", 'category.id eq 123', "name like 'Welcome'") and $orderBy.
list_attribute_set_definitionsList Contact Builder attribute set definitions and their attributes, with page-number pagination.
list_automationsList Automation Studio automations with page-number pagination (page_size up to 500), optionally sorted (order_by) and filtered (filter).
list_campaign_assetsList the assets (emails, journeys, ...) associated with a campaign.
list_campaignsList Marketing Cloud campaigns with optional $orderBy (e.g. 'createdDate DESC').
list_contact_journeysList which journeys (key and version) the given contacts are currently in, plus contact keys that were not found.
list_data_extension_fieldsList a data extension's fields (column names, types, lengths, primary keys, nullability).
list_data_extensionsList data extensions with page-number pagination (page, page_size; use page_info.next_page).
list_email_send_definitionsList transactional email send definitions with page-number pagination (page_size up to 100, the API maximum).
list_event_definitionsList Journey Builder event definitions (entry sources) with their id and eventDefinitionKey, optionally filtered by name.
list_foldersList Marketing Cloud folders of one type, e.g. category_type 'dataextension'.
list_journeysList Journey Builder journeys (lean summaries: id, key, version, status).
search_assetsSearch Content Builder assets with an advanced query: nested AND/OR operand trees, multiple sort clauses, and a field projection.
search_contacts_by_emailFind contacts by email address (1-100 addresses).
validate_credentialValidate Salesforce Marketing Cloud credentials by fetching the token context (enterprise, business unit, and user) for the connected account.
validate_email_addressCheck whether an email address is valid before sending: syntax, whether the domain accepts mail (MX), and known-bad address lists.

Write (12)​

Create or send data.

ToolWhat it does
add_campaign_assetAssociate one or more items with a campaign, e.g. asset_type 'EMAIL' with item_ids from list_assets.
create_assetCreate a Content Builder asset.
create_asset_categoryCreate a Content Builder folder under a parent folder.
create_campaignCreate a campaign.
create_contactCreate a contact with attribute values grouped by attribute set (most accounts require the 'Email Addresses' set).
create_data_extensionCreate a data extension with at least one field.
create_data_extension_fieldAdd one or more fields (columns) to an existing data extension.
create_email_send_definitionCreate a transactional email send definition that links a Content Builder email to a subscriber list.
create_event_definitionCreate a journey entry event (e.g. type 'APIEvent') bound to a data extension.
create_journeyCreate a journey from a Journey Spec (key, name, triggers, activities).
fire_entry_eventInject a contact into a published journey by firing its API entry event.
send_transactional_emailSend a real transactional email to 1-500 recipients using an active send definition.

Delete or overwrite (27)​

Remove or replace existing data.

ToolWhat it does
clear_data_extensionDelete ALL rows from a data extension, keeping its structure.
delete_assetDelete a Content Builder asset by ID.
delete_asset_categoryDelete a Content Builder folder by ID.
delete_campaignDelete a campaign by ID.
delete_contactsDelete contacts by contact key.
delete_data_extensionPermanently delete a data extension and all its rows.
delete_email_send_definitionDelete a transactional email send definition by definition key.
delete_event_definitionDelete an event definition.
delete_journeyDelete a journey, or one version with version_number.
pause_journeyPause a running journey version (contacts hold in place).
publish_journeyStart publishing (activating) a journey version asynchronously.
remove_campaign_assetRemove an asset association from a campaign. campaign_asset_id is the association id from list_campaign_assets (or add_campaign_asset), NOT the email or item ID.
remove_contacts_from_journeyRemove up to 50 contacts from journeys (inverse of fire_entry_event).
resume_journeyResume a paused journey version (inverse of pause_journey).
run_automationRun an automation once now, performing all of its activities (queries, imports, sends).
stop_journeyStop a running journey version; contacts exit and it cannot be restarted (inverse of publish_journey).
update_assetUpdate a Content Builder asset (partial PATCH): name, description, folder, content, views, data, meta, channels, or asset type.
update_asset_categoryRename or move a Content Builder folder (full PUT: name and parent_id are both required).
update_campaignUpdate a campaign's name, description, campaign_code, color, or favorite flag.
update_contactUpdate an existing contact's attribute values, grouped by attribute set.
update_data_extensionUpdate a data extension's name, description, sendable/testable flags, or retention settings.
update_data_extension_fieldChange existing data extension fields (length, scale, nullability, default value), matched by name.
update_email_send_definitionUpdate a transactional email send definition: name, description, status (Active/Inactive), classification, email asset, subscriptions, or options.
update_event_definitionReplace an event definition (full body: type, name, key, data extension).
update_journeyReplace a draft journey version's full Journey Spec.
upsert_data_extension_rowsInsert or update up to 500 rows synchronously, matched on primary key columns.
upsert_data_extension_rows_asyncQueue a large batch of rows for a data extension asynchronously. mode 'upsert' (default) inserts or updates by primary key; 'insert' only adds new rows.
⌘J