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.comand 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
- Go to Organization > Connectors and find Salesforce Marketing Cloud.
- Click Enable and choose which tools to allow.
- 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.
| Tool | What it does |
|---|---|
get_asset | Get one Content Builder asset by ID, including its full content, views, data, and meta. |
get_async_request_results | Get per-row results (status, errorCode, message) of a completed asynchronous data request, with page-number pagination. |
get_async_request_status | Get the processing status of an asynchronous data request (requestStatus, resultStatus, hasErrors). |
get_automation | Get one automation by ID, including its schedule, status, and steps with their activities. |
get_campaign | Get one campaign by ID. |
get_contact_delete_status | Get the status of a contact delete operation started by delete_contacts. |
get_data_extension | Get one data extension's properties (name, key, folder, sendable settings, row count) by ID. |
get_data_extension_rows | Read 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_status | Get the send status of one transactional email message by message key (e.g. 'TransactionalSendEvents.EmailSent'). |
get_email_send_definition | Get one transactional email send definition by its definition key, including its email asset, subscription settings, and options. |
get_event_definition | Get one event definition by event_definition_id or key (exactly one). |
get_journey | Get a journey's full definition (triggers, activities, goals, exits) by journey_id or key (exactly one). |
get_journey_audit_log | Get a journey's audit log (who created, modified, published, unpublished, or deleted it), optionally filtered by action. |
get_journey_exit_status | Check whether contacts removed with remove_contacts_from_journey have exited. |
get_journey_publish_status | Check the progress of a publish_journey request by its status_id. |
list_asset_categories | List Content Builder categories (folders) with optional $filter (e.g. 'parentId eq 516016'), $orderBy, and scope ('Shared'). |
list_assets | List 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_definitions | List Contact Builder attribute set definitions and their attributes, with page-number pagination. |
list_automations | List Automation Studio automations with page-number pagination (page_size up to 500), optionally sorted (order_by) and filtered (filter). |
list_campaign_assets | List the assets (emails, journeys, ...) associated with a campaign. |
list_campaigns | List Marketing Cloud campaigns with optional $orderBy (e.g. 'createdDate DESC'). |
list_contact_journeys | List which journeys (key and version) the given contacts are currently in, plus contact keys that were not found. |
list_data_extension_fields | List a data extension's fields (column names, types, lengths, primary keys, nullability). |
list_data_extensions | List data extensions with page-number pagination (page, page_size; use page_info.next_page). |
list_email_send_definitions | List transactional email send definitions with page-number pagination (page_size up to 100, the API maximum). |
list_event_definitions | List Journey Builder event definitions (entry sources) with their id and eventDefinitionKey, optionally filtered by name. |
list_folders | List Marketing Cloud folders of one type, e.g. category_type 'dataextension'. |
list_journeys | List Journey Builder journeys (lean summaries: id, key, version, status). |
search_assets | Search Content Builder assets with an advanced query: nested AND/OR operand trees, multiple sort clauses, and a field projection. |
search_contacts_by_email | Find contacts by email address (1-100 addresses). |
validate_credential | Validate Salesforce Marketing Cloud credentials by fetching the token context (enterprise, business unit, and user) for the connected account. |
validate_email_address | Check 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.
| Tool | What it does |
|---|---|
add_campaign_asset | Associate one or more items with a campaign, e.g. asset_type 'EMAIL' with item_ids from list_assets. |
create_asset | Create a Content Builder asset. |
create_asset_category | Create a Content Builder folder under a parent folder. |
create_campaign | Create a campaign. |
create_contact | Create a contact with attribute values grouped by attribute set (most accounts require the 'Email Addresses' set). |
create_data_extension | Create a data extension with at least one field. |
create_data_extension_field | Add one or more fields (columns) to an existing data extension. |
create_email_send_definition | Create a transactional email send definition that links a Content Builder email to a subscriber list. |
create_event_definition | Create a journey entry event (e.g. type 'APIEvent') bound to a data extension. |
create_journey | Create a journey from a Journey Spec (key, name, triggers, activities). |
fire_entry_event | Inject a contact into a published journey by firing its API entry event. |
send_transactional_email | Send a real transactional email to 1-500 recipients using an active send definition. |
Delete or overwrite (27)
Remove or replace existing data.
| Tool | What it does |
|---|---|
clear_data_extension | Delete ALL rows from a data extension, keeping its structure. |
delete_asset | Delete a Content Builder asset by ID. |
delete_asset_category | Delete a Content Builder folder by ID. |
delete_campaign | Delete a campaign by ID. |
delete_contacts | Delete contacts by contact key. |
delete_data_extension | Permanently delete a data extension and all its rows. |
delete_email_send_definition | Delete a transactional email send definition by definition key. |
delete_event_definition | Delete an event definition. |
delete_journey | Delete a journey, or one version with version_number. |
pause_journey | Pause a running journey version (contacts hold in place). |
publish_journey | Start publishing (activating) a journey version asynchronously. |
remove_campaign_asset | Remove 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_journey | Remove up to 50 contacts from journeys (inverse of fire_entry_event). |
resume_journey | Resume a paused journey version (inverse of pause_journey). |
run_automation | Run an automation once now, performing all of its activities (queries, imports, sends). |
stop_journey | Stop a running journey version; contacts exit and it cannot be restarted (inverse of publish_journey). |
update_asset | Update a Content Builder asset (partial PATCH): name, description, folder, content, views, data, meta, channels, or asset type. |
update_asset_category | Rename or move a Content Builder folder (full PUT: name and parent_id are both required). |
update_campaign | Update a campaign's name, description, campaign_code, color, or favorite flag. |
update_contact | Update an existing contact's attribute values, grouped by attribute set. |
update_data_extension | Update a data extension's name, description, sendable/testable flags, or retention settings. |
update_data_extension_field | Change existing data extension fields (length, scale, nullability, default value), matched by name. |
update_email_send_definition | Update a transactional email send definition: name, description, status (Active/Inactive), classification, email asset, subscriptions, or options. |
update_event_definition | Replace an event definition (full body: type, name, key, data extension). |
update_journey | Replace a draft journey version's full Journey Spec. |
upsert_data_extension_rows | Insert or update up to 500 rows synchronously, matched on primary key columns. |
upsert_data_extension_rows_async | Queue a large batch of rows for a data extension asynchronously. mode 'upsert' (default) inserts or updates by primary key; 'insert' only adds new rows. |