Connectors

Marketing & Customer Engagement

Marketing Cloud

Salesforce Marketing Cloud: contacts, journeys, email, SMS, push, and automations
Signs in with
OAuth 2.0 sign-in
Runs on
Cloud or On-Prem Worker
Operations
308
Ready-made triggers
0

Connect Marketing Cloud

  1. In Neblex open Connect › Connections and click New Connection.
  2. Search for Marketing Cloud and give the connection a clear name.
  3. Fill in the fields. Secret values are encrypted and never shown again.
  4. Click Test, then Create Connection.
For services offered under Connect a Service you only sign in and approve access. Otherwise use Connect with OAuth2 with your own OAuth app. See Authorize with OAuth.
FieldWhat to enter
SubdomainRequiredThe tenant subdomain of your REST and Authentication Base URIs: the part before .rest.marketingcloudapis.com.
Token endpointRequiredYour Authentication Base URI followed by v2/token, for example https://YOUR_SUBDOMAIN.auth.marketingcloudapis.com/v2/token.
Client IDRequiredClient ID of the server-to-server API integration in Installed Packages.
Client secretRequiredSecretClient secret of the API integration.
ScopeOptionalOptional space-separated scopes to request; empty requests every scope the integration has.
Business unitOptionalOptional token request settings.
Token requestRequiredMarketing Cloud takes the client credentials in a JSON token request body.

Use it in a flow

  1. Open a flow, open the node library and search for Marketing Cloud.
  2. Drag it onto the canvas and choose an Operation and your connection.
  3. Map the operation's fields from earlier steps, or click Map with Matt.
  4. Use Test this step to see what it returns, then save.

To start a flow from Marketing Cloud without a ready-made trigger: a Poll for changes trigger can check one of its list operations on a schedule and pass on only what is new; if Marketing Cloud can send webhooks, a Webhook trigger receives them at its own URL.

Operations

308 operations in 30 groups. Each one is a step you can add to a flow.

Address1
Validates an email addressvalidateEmailPOSTProcesses an email address through one or more validators.
Approvals7
Creates an approval item and an associated a workflow item. The response includes details of the approval and workflowcreateApprovalItemPOSTCreates an approval item and an associated a workflow item.
GET /hub/v1/approvals-v2/settingsgetApprovalSettingsGETGET /hub/v1/approvals-v2/settings
GET /hub/v1/approvals-v2/{id}/rolesgetApprovalRolesGETGET /hub/v1/approvals-v2/{id}/roles
Modifies the name, description, and deadline of an existing approval item. The response contains detailsmodifyApprovalItemPATCHModifies the name, description, and deadline of an existing approval item.
PATCH /hub/v1/approvals-v2/settingsupdateApprovalSettingsPATCHPATCH /hub/v1/approvals-v2/settings
Retrieves all approval items that belong to the current user. To filter the results, use the request parametersgetApprovalItemsGETRetrieves all approval items that belong to the current user.
Retrieves an approval item that belongs to the current user. The response includes details of the approval and workflowgetApprovalItemGETRetrieves an approval item that belongs to the current user.
Assets18
Archive an assetarchiveAssetPATCHArchive an asset.
Create assetcreateAssetPOSTCreates a new asset.
Create categorycreateCategoryPOSTCreates a category in Content Builder.
Delete an assetdeleteAssetDELETEDeletes an asset.
Delete categorydeleteCategoryDELETEDeletes a Content Builder category.
Get asset by IDgetAssetGETRetrieves an asset by its ID.
Get asset filegetFileGETGets the binary file for an asset.
Get assets by advanced querygetAssetsAdvancedQueryPOSTUse an advanced query to retrieve a collection of assets.
Get assets by simple filtergetAssetsSimpleQueryGETRetrieve a collection of assets by applying basic filters and sorting rules.
Get categoriesgetCategoriesGETReturns one or more Content Builder categories that are owned by or reside in your MID.
Get category by IDgetCategoryGETReturns one Content Builder category by ID.
Get channel viewgetChannelViewGETReturns the compiled HTML for a requested channel view of an asset.
Get default salutationsgetSalutationsGETRetrieves the default header and footer for an account.
Get email salutationsgetHeaderAndFooterGETRetrieves the header and footer of an email asset by specifying the asset ID.
Patch an assetpatchAssetPATCHModify the properties of an asset deleted in the last 30 days.
Restore assetrestoreAssetPATCHRestore an asset hidden by a prior archive operation, and make it available again for queries, triggered sends, journeys, and other operations.
Update an assetupdateAssetPUTModify the properties of an existing asset.
Update categoryupdateCategoryPUTUpdates a Content Builder category.
Audits2
GET /data/v1/audit/auditEventsgetAuditEventsGETRetrieve logged Audit Trail audit events for the current account and its child accounts.
GET /data/v1/audit/securityEventsgetSecurityEventsGETRetrieve logged Audit Trail security events for the current account and its children.
Auth2
Get base URLsgetBaseUrlsGETObtain the base URLs for the Marketing Cloud Auth and REST APIs.
Get user informationgetUserInfoGETRetrieves information about the account and user that are associated with the access token.
Automation Studio20
Activate or deactivate an automation file trigger by providing its IDupdateAutomationFileTriggerPATCHRequired Scopes
Activate or deactivate an automation file trigger by providing its keyupdateAutomationFileTriggerByKeyPATCHRequired Scopes
Activate or Deactivate an Automation TriggerupdateAutomationTriggerPATCHRequired scopes
Add a file transfer activity to the queue for processingstartFileTransferActivityPOSTAdd a file transfer activity to the queue for processing.
Check the status for a specified Trigger API requestIDgetTriggerStatusGETNote To see the automation details, make sure that the request's file details meet the criteria for exactly one automation trigger configuration.
Create a file transfer activitycreateFileTransferActivityPOSTCreate a file transfer activity.
Create an automation using existing Automation Studio activitiescreateAutomationPOSTRequired Scopes
Delete a specific file transfer activity by providing its IDdeleteFileTransferActivityDELETEDelete a specific file transfer activity by providing its ID.
Retrieve a list of all automations in the accountgetAutomationsGETRequired Scopes
Retrieve a list of all file transfer activities in the accountgetFileTransferActivitiesGETRetrieve a list of all file transfer activities in the account.
Retrieve a list of all folders in the accountgetAutomationFoldersGETRequired Scopes
Retrieve a list of all FTP locations in the accountgetFtpLocationsGETRequired Scopes
Retrieve a list of automation script activitiesgetAutomationScriptActivitiesGETRequired Scopes
Retrieve a specific automation by providing its IDgetAutomationGETRequired Scopes
Retrieve a specific file transfer activity by providing its IDgetFileTransferActivityGETRetrieve a specific file transfer activity by providing its ID.
Run a script activity one timeexecuteScriptActivityPOSTRequired Scopes
Run all activities in an automation one time by specifying its external keyexecuteAutomationActivitiesByKeyPOSTRequired Scopes
Run all activities in an automation one time by specifying its IDexecuteAutomationActivitiesPOSTRequired Scopes
Start an automation that uses a trigger start sourceexecuteTriggeredAutomationPOSTWhen you upload a file, the Trigger API request passes the file details for Automation Studio to evaluate.
Update a file transfer activity by providing its IDupdateFileTransferActivityPATCHUpdate a file transfer activity by providing its ID.
Bulk Data Ingest9
Complete data staging for a bulk data ingest jobcompleteDataStagingPOSTRequired Scopes
Create a bulk data ingestion jobcreateBulkIngestJobPOSTCreate a bulk data ingestion job.
Delete the job definition of a bulk data ingest jobdeleteBulkIngestJobDefinitionDELETEDeletes an active bulk data ingest job.
Get a summary for a completed bulk data ingestion jobgetBulkDataIngestJobSummaryGETView a summary of a completed bulk data ingest job.
Get the job definition of a bulk data ingest jobgetBulkIngestJobDefinitionGETGet the job definition of a bulk data ingest job.
Get the validation results of a bulk data ingest jobgetBulkDataIngestJobValidationResultsGETGet the validation results for a completed bulk data ingest job.
Get the validation summary of a bulk data ingest jobgetBulkDataIngestJobValidationSummaryGETGet a validation summary for a completed bulk data ingest job.
Stage data for a bulk data ingest jobstageDataForBulkIngestJobPUTStage data to import in a bulk job.
Update the job definition of an existing bulk data ingest jobupdateBulkIngestJobDefinitionPATCHUpdate the job definition of a bulk data ingest job.
Campaigns9
Associate an asset with a campaignaddAssetToCampaignPOSTRequired permission scope: Campaign Write
Create a campaigncreateCampaignPOSTRequired permission scope: Campaign Write
Delete a campaigndeleteCampaignDELETERequired permission scope: Campaign Write
Remove an association between an asset and a campaignremoveAssetFromCampaignDELETERequired permission scope: Campaign Write
Retrieve a list of assets that are associated with a campaigngetCampaignAssetsGETRequired permission scope: Campaign Read
Retrieve a list of campaigns in your accountgetCampaignsGETRequired permission scope: Campaign Read
Retrieve information about a single campaigngetCampaignGETRequired permission scope: Campaign Read
Retrieve information about a specific asset that is associated with a campaigngetCampaignAssetGETRequired permission scope: Campaign Read
Update a campaignupdateCampaignPATCHRequired permission scope: Campaign Write
Chat Messaging5
GET /ott/v1/registration/{platform}ottRetrieveRegistrationCollectionGETGET /ott/v1/registration/{platform}
GET /ott/v1/registration/{platform}/{ottPropertyId}ottRetrieveRegistrationPropertyGETGET /ott/v1/registration/{platform}/{ottPropertyId}
GET /ott/v1/send/{messageId}ottRetrieveSentMessageGETGET /ott/v1/send/{messageId}
Register a property for a specific OTT platform. If you try to register an existing Messenger Page ID or LINE ChannelottRegisterPropertyPOSTRegister a property for a specific OTT platform.
Send an OTT message to the recipient. Supported OTT networks are Facebook Messenger and LINEottSendMessageToRecipientPOSTSend an OTT message to the recipient.
Contacts40
Adds consent management information to contact records by contact ID for data protection and privacy concernsaddContactPreferencesByIdPOSTAdds consent management information to contact records by contact ID for data protection and privacy concerns.
Asynchronously deletes a contact when provided with its contact ID. Use the OperationID value returned to checkdeleteByContactIDsPOSTAsynchronously deletes a contact when provided with its contact ID.
Asynchronously deletes a contact when provided with its contact key. Use the OperationID value returned to checkdeleteByContactKeysPOSTAsynchronously deletes a contact when provided with its contact key.
Creates or returns a contact using the Contact Key and Contact Type provided in the payloadestablishContactsDetailPOSTCreates or returns a contact using the Contact Key and Contact Type provided in the payload.
Deletes contacts based on specified list reference value. This operations runs asynchronously. Use the OperationIDdeleteByListReferencePOSTDeletes contacts based on specified list reference value.
GET /contacts/v1/contacts/actions/delete/status?operationID=contactsDeleteStatusGETGET /contacts/v1/contacts/actions/delete/status?operationID=
GET /contacts/v1/contacts/actions/restrict/status?operationID=contactsRestrictStatusGETGET /contacts/v1/contacts/actions/restrict/status?operationID=
GET /contacts/v1/contacts/analytics/deleterequests/summarycontactsDeleteRequestsSummaryGETGET /contacts/v1/contacts/analytics/deleterequests/summary
GET /contacts/v1/contacts/deleteOperationsgetListOfContactDeleteOperationsGETGET /contacts/v1/contacts/deleteOperations
GET /contacts/v1/contacts/id:{contactId}/PreferencesgetContactPreferencesByIdGETGET /contacts/v1/contacts/id:{contactId}/Preferences
GET /contacts/v1/contacts/key:{contactKey}/PreferencesgetContactPreferencesByKeyGETGET /contacts/v1/contacts/key:{contactKey}/Preferences
GET /contacts/v1/customObject/{id}/isUsedInContactsgetCustomObjectGETGET /contacts/v1/customObject/{id}/isUsedInContacts
GET /contacts/v1/customobjectfield/{id}/relationshipsretrieveCustomObjectFieldRelationshipsGETGET /contacts/v1/customobjectfield/{id}/relationships
GET /contacts/v1/schemaschemasCollectionGETGET /contacts/v1/schema
GET /contacts/v1/schemas/{schemaId}/attributeGroupsretrieveAttributeGroupsGETGET /contacts/v1/schemas/{schemaId}/attributeGroups
GET /contacts/v1/schemas/{schemaId}/attributeGroups/{id}retrieveAttributeGroupsIDGETGET /contacts/v1/schemas/{schemaId}/attributeGroups/{id}
POST /contacts/v1/addresses/search/{attributeName}fetchContactsAddressesBySearchCriteriaPOSTPOST /contacts/v1/addresses/search/{attributeName}
POST /contacts/v1/attributeGroups/populationcreatePopulationAttributeGroupPOSTPOST /contacts/v1/attributeGroups/population
POST /contacts/v1/attributeSets/{id}attributeSetsDataIDInsertPOSTPOST /contacts/v1/attributeSets/{id}
POST /contacts/v1/contactscreateContactsPOSTPOST /contacts/v1/contacts
POST /contacts/v1/contacts/actions/delete/configSettingscontactsDeleteConfigStatusPOSTPOST /contacts/v1/contacts/actions/delete/configSettings
POST /contacts/v1/contacts/actions/delete/optionsgetDeleteOptionsPOSTPOST /contacts/v1/contacts/actions/delete/options
POST /contacts/v1/contacts/actions/restrict?type=idsrestrictContactIdPOSTPOST /contacts/v1/contacts/actions/restrict?type=ids
POST /contacts/v1/contacts/actions/restrict?type=keysrestrictContactKeyPOSTPOST /contacts/v1/contacts/actions/restrict?type=keys
POST /contacts/v1/contacts/actions/restrict?type=listReferencerestrictContactListreferencePOSTPOST /contacts/v1/contacts/actions/restrict?type=listReference
POST /contacts/v1/contacts/preferencesaddContactPreferencesPOSTPOST /contacts/v1/contacts/preferences
POST /contacts/v1/contacts/preferences/search?ReferenceType={ReferenceType}searchContactPreferencesByReferenceTypePOSTPOST /contacts/v1/contacts/preferences/search?ReferenceType={ReferenceType}
POST /contacts/v1/operations/delete/{operationID}/retryretryContactDeletePOSTPOST /contacts/v1/operations/delete/{operationID}/retry
POST /contacts/v1/operations/restrict/{operationID}/retryretryContactRestrictPOSTPOST /contacts/v1/operations/restrict/{operationID}/retry
POST /interaction/v1/interactions/contactexitcontactExitRequestPOSTPOST /interaction/v1/interactions/contactexit
POST /interaction/v1/interactions/contactexit/statuscontactExitStatusPOSTPOST /interaction/v1/interactions/contactexit/status
Provides a list of journeys and journey versions for a list of contact keyscontactMembershipRequestPOSTProvides a list of journeys and journey versions for a list of contact keys.
Retrieve the contact key for one or more email addresses. This resource is helpful for situations where you needretrieveContactKeyPOSTRetrieve the contact key for one or more email addresses.
Retrieve the number of contacts who meet a set of search criteriafetchContactsAddressesCountSearchCriteriaPOSTRetrieve the number of contacts who meet a set of search criteria.
Retrieves a collection of attribute value containers or the data rows of a specified attribute set by nameattributeSetsDataNameGETRetrieves a collection of attribute value containers or the data rows of a specified attribute set by name.
Retrieves all attribute set definition from your contact data modelretrieveAllAttributeSetDefinitionsGETRetrieves all attribute set definition from your contact data model.
Retrieves an attribute set definition from your contact data modelretrieveAttributeSetDefinitionsGETRetrieves an attribute set definition from your contact data model.
Retrieves details of contact delete requests for a date rangecontactsDeleteRequestsDetailsGETRetrieves details of contact delete requests for a date range.
Updates a collection of attribute value containers or the data rows of a specified attribute set by ID or nameattributeSetsDataIDUpdatePATCHUpdates a collection of attribute value containers or the data rows of a specified attribute set by ID or name.
Updates a contact recordupdateContactsPATCHUpdates a contact record.
Data Extension Data3
Retrieve data from a data extension by providing its external keygetDataByKeyGETRetrieve data from a data extension by providing its external key.
Retrieve data from a data extension by providing its IDgetDataGETRetrieve data from a data extension by providing its ID.
Retrieve data from a data extension by providing the request token. The $filter, $pagesize, $top, $fields, and $orderbygetDataByRequestTokenGETRetrieve data from a data extension by providing the request token.
Data Extension Imports4
Get import row-level validation details by IDgetValidationDetailsOfAOneTimeDataImportGETReturns details of row-level validation errors that occurred during an import.
Queue and start a one-time import into a data extension without creating an import definitionqueueAndStartAOneTimeDataImportPOSTPerform a file-based import without creating an import definition.
Retrieve a list of row-level validation errors that occurred during an import. Use this method after an import finishesgetValidationSummaryForADataImportGETRetrieve a list of row-level validation errors that occurred during an import.
Returns the status of a queued data import, including the final number of imported rows and the import status (SuccessgetStatusOfAOneTimeDataImportGETReturns the status of a queued data import, including the final number of imported rows and the import status (Success or Error).
Data Extension Rows (Asynchronous)4
Add rows to a data extension asynchronouslyinsertRowsPOSTFor information about the limits that apply to this API, see Salesforce Help : Limits and Guidelines.
Asynchronously update rows in a data extension if the primary key exists, or create rows if the primary key doesn'tupsertRowsPUTFor information about the limits that apply to this API, see Salesforce Help : Limits and Guidelines.
Retrieve the results of a request to asynchronously insert rows into a data extensiongetRequestResultsGETFor information about the limits that apply to this API, see Salesforce Help : Limits and Guidelines.
Retrieve the status of a request to asynchronously insert rows into a data extensiongetRequestStatusGETFor information about the limits that apply to this API, see Salesforce Help : Limits and Guidelines.
Data Extension Rows (Synchronous)6
Increase or decrease the value of a data extension column synchronously. For example, you can use this operationincrementColumnValuePUTIncrease or decrease the value of a data extension column synchronously.
Increase or decrease the value of a data extension column synchronously. For example, you can use this operationincrementColumnValueByKeyPUTIncrease or decrease the value of a data extension column synchronously.
Upsert one or more rows in a data extension synchronously by specifying the external key of the target data extensionupsertRowsetByKeyPOSTUpsert one or more rows in a data extension synchronously by specifying the external key of the target data extension.
Upsert one or more rows in a data extension synchronously by specifying the ID of the target data extensionupsertRowsetPOSTUpsert one or more rows in a data extension synchronously by specifying the ID of the target data extension.
Upsert one row in a data extension synchronously by specifying the external key of the target data extensionupsertRowByKeyPUTThe API doesn't accept URLs that contain more than 260 characters.
Upsert one row in a data extension synchronously by specifying the ID of the target data extensionupsertRowPUTSpecify the primary key and value in the URL path.
Data Extensions10
Creates a data extensioncreateDataExtensionPOSTRequired Scopes
Deletes a data extensiondeleteDataExtensionDELETERequired Scopes
Deletes all of the data in a data extensionclearDataExtensionDataPOSTRequired Scopes
Inserts a new field into a data extensioncreateDataExtensionFieldPOSTRequired Scopes
Retrieves a list of data extensions based on the ID of the parent categorygetDataExtensionsByCategoryIdGETRequired Scopes
Retrieves a list of data extensions that match a search stringgetDataExtensionsGETRequired Scopes
Retrieves a list of fields in a data extensiongetDataExtensionFieldsGETRequired Scopes
Retrieves information about the specified data extension by providing its IDgetDataExtensionGETRequired Scopes
Update the fields in a data extensionupdateDataExtensionPATCHRequired Scopes
Updates a field in a data extensionupdateDataExtensionFieldPATCHRequired Permission Scope
Domain Verification8
Create a domaincreateDomainPOSTCreates an email or domain record.
Create domains in bulkcreateDomainsBulkPOSTCreates multiple sender email address records.
Delete an address or domaindeleteDomainPOSTDeletes an email address or domain record.
Get domainsgetDomainsGETRetrieves a list of email addresses and domains that can be used to send email from a Marketing Cloud Engagement account.
Push registered domains to other business unitspushRegisteredDomainsPOSTMakes one or more registered domains available in other business units (BUs) that share an Enterprise ID (EID).
Register an email domainregisterDomainPOSTRegisters a new domain to use for sending email.
Retrieve a domain verification tokenretrieveDomainVerificationTokenPOSTRetrieves a verification token for a domain.
Update an address or domainupdateDomainPOSTUpdates the status of the IsSendable field for an email address or domain record.
Event Notification12
Creates a single subscription. A subscription indicates which event types to receive notifications for and whichcreateSubscriptionPOSTCreates a single subscription.
DELETE /platform/v1/ens-callbacks/{callbackId}deleteCallbackDELETEDELETE /platform/v1/ens-callbacks/{callbackId}
DELETE /platform/v1/ens-subscriptions/{subscriptionId}deleteSubscriptionDELETEDELETE /platform/v1/ens-subscriptions/{subscriptionId}
GET /platform/v1/ens-callbacks/{callbackId}getCallbackGETGET /platform/v1/ens-callbacks/{callbackId}
GET /platform/v1/ens-subscriptions-by-cb/{callbackId}getAllSubscriptionsForCallbackGETGET /platform/v1/ens-subscriptions-by-cb/{callbackId}
GET /platform/v1/ens-subscriptions/{subscriptionId}getSubscriptionGETGET /platform/v1/ens-subscriptions/{subscriptionId}
PUT /platform/v1/ens-callbacksupdateCallbackPUTPUT /platform/v1/ens-callbacks
PUT /platform/v1/ens-subscriptionsupdateSubscriptionPUTPUT /platform/v1/ens-subscriptions
Regenerates a signature key for a given callback. Regenerating a signature key deactivates the existing keyregenerateSignatureKeyPUTRegenerates a signature key for a given callback.
Registers a new callback to receive event notifications. You must register and verify your callback before you use itcreateCallbackPOSTRegisters a new callback to receive event notifications.
Retrieves details about all registered callbacksgetAllCallbacksGETRetrieves details about all registered callbacks.
Verifies a callback so that it can receive notificationsverifyCallbackPOSTVerifies a callback so that it can receive notifications.
File Transfer Locations6
Create a new File Transfer Location in your accountcreateAFileTransferLocationPOSTThis method creates a new file location.
Deactivate a file transfer location identified by customerKeydeleteAFileTransferLocationDELETEThis method deactivates a file location based on a given customer key.
Get a file transfer location identified by customerKeygetAFileTransferLocationGETThis method returns a single file location for the given customer key.
Get all file transfer locations for the current MIDgetAllFileTransferLocationsGETThis method returns one or more file locations that are owned by, or reside under your member identification code (MID).
Update a file transfer location identified by customerKeyupdateAFileTransferLocationPATCHThis method updates a file location based on a given customer key.
Validate a file transfer location schema passed in request bodyvalidateAFileTransferLocationPOSTThis method validates a file location.
Journeys and Events28
Checks the status of a publicationgetPublishStatusGETChecks the status of a publication.
Create an Event Definition, which contains the name and data schema for an event. The resource uses this keycreateEventDefinitionPOSTCreate an Event Definition, which contains the name and data schema for an event.
DELETE /interaction/v1/eventDefinitions/{id}deleteEventDefinitionDELETEDELETE /interaction/v1/eventDefinitions/{id}
DELETE /interaction/v1/interactions/{id}deleteInteractionByIdDELETEDELETE /interaction/v1/interactions/{id}
Downloads journey history to a file. You can specify which fields are returned. The maximum file size is 1 GB, but youdownloadJourneyHistoryPOSTDownloads journey history to a file.
Enter a batch of subscribers into a journey or release a batch of subscribers from a wait event asynchronouslyenterContactsIntoJourneyInBatchesPOSTEnter a batch of subscribers into a journey or release a batch of subscribers from a wait event asynchronously.
GET /interaction/v1/eventDefinitions/{id}getEventDefinitionGETGET /interaction/v1/eventDefinitions/{id}
GET /interaction/v1/interactions/{id}getInteractionByIdGETGET /interaction/v1/interactions/{id}
GET /interaction/v1/restrestDiscoveryGETGET /interaction/v1/rest
Insert subscribers into a journey synchronouslypostEventPOSTInsert subscribers into a journey synchronously.
Pause a journey that's currently running by specifying its external key. To pause a journey by specifying its ID, usejourneyPauseByDefinitionKeyPOSTPause a journey that's currently running by specifying its external key.
Pause a journey that's currently running by specifying its ID. To pause a journey by specifying its external key, usejourneyPauseByDefinitionIdPOSTPause a journey that's currently running by specifying its ID.
POST /interaction/v1/interactionspostCreateInteractionPOSTPOST /interaction/v1/interactions
Post /interaction/v1/interactions/contactexitinteractionContactExitRequestPOSTPost /interaction/v1/interactions/contactexit
Post /interaction/v1/interactions/contactexit/statusinteractiveContactExitStatusPOSTPost /interaction/v1/interactions/contactexit/status
POST /interaction/v1/interactions/publishAsync/{id}?versionNumber={versionNumber}postPublishInteractionByIdPOSTPOST /interaction/v1/interactions/publishAsync/{id}?versionNumber={versionNumber}
POST /interaction/v1/interactions/resume/key:{definitionKey}?versionNumber={versionNumber}journeyResumeByDefinitionKeyPOSTPOST /interaction/v1/interactions/resume/key:{definitionKey}?versionNumber={versionNumber}
POST /interaction/v1/interactions/resume/{definitionID}?versionNumber={versionNumber}journeyResumeByDefinitionIdPOSTPOST /interaction/v1/interactions/resume/{definitionID}?versionNumber={versionNumber}
POST /interaction/v1/interactions/stop/{definitionId}?versionNumber={versionNumber}postStopInteractionByIdPOSTPOST /interaction/v1/interactions/stop/{definitionId}?versionNumber={versionNumber}
Provides an estimate of the amount of time that journey history events trail behind actual journey eventsgetJourneyHistoryDownloadFreshnessGETProvides an estimate of the amount of time that journey history events trail behind actual journey events.
Retrieve a collection of event definitionsgetEventDefinitionsGETRetrieve a collection of event definitions.
Retrieve a list of journeysgetInteractionCollectionGETRetrieve a list of journeys.
Retrieve the status of contacts that were inserted into a journey using the POST method . Use this operationgetStatusOfContactsGETRetrieve the status of contacts that were inserted into a journey using the POST method .
Retrieves an audit log for one or all versions of a journey by specifying its external key. You can specify differentgetInteractionAuditLogByKeyGETRetrieves an audit log for one or all versions of a journey by specifying its external key.
Retrieves an audit log for one or all versions of a journey by specifying its ID. You can specify different actionsgetInteractionAuditLogGETRetrieves an audit log for one or all versions of a journey by specifying its ID.
Returns an estimate of the number of rows that the journey history download request generates for a given query.getJourneyHistoryDownloadEstimatePOSTReturns an estimate of the number of rows that the journey history download request generates for a given query.
Updates a journey version. To call this resource, assign your API Integration the Automation | Interactions | ReadputUpdateInteractionPUTUpdates a journey version.
Updates an event definition by ID or key. Once an event definition is created, only a few properties can be updated.updateEventDefinitionPUTUpdates an event definition by ID or key.
Messaging2
GET /messaging/v1/messageDefinitionSends/key:{key}/deliveryRecordsmessageDefinitionSendsDeliveryRecordsGETGET /messaging/v1/messageDefinitionSends/key:{key}/deliveryRecords
POST /messaging/v1/messageDefinitionSends/{triggeredSendDefinitionId}/sendmessageDefinitionSendsPOSTPOST /messaging/v1/messageDefinitionSends/{triggeredSendDefinitionId}/send
Nested Tags8
Add tags to objects to help identify and categorize them. An object can have multiple tags, and a tag can be associatedcreateTagsPOSTAdd tags to objects to help identify and categorize them.
Creates a tag that can be associated with any object that accepts tagging. The tag must contain a unique name. The tagcreateNestedTagsPOSTCreates a tag that can be associated with any object that accepts tagging.
DELETE /hub/v1/nestedtags/{tagId}deleteNestedTagsDELETEDELETE /hub/v1/nestedtags/{tagId}
GET /hub/v1/nestedtagsgetNestedTagsGETGET /hub/v1/nestedtags
GET /hub/v1/nestedtags/{tagId}getNestedTagByIdGETGET /hub/v1/nestedtags/{tagId}
PUT /hub/v1/nestedtags/{tagId}updateNestedTagsPUTPUT /hub/v1/nestedtags/{tagId}
Updates an existing tag. Provide only the tag fields to be changedpatchNestedTagsPATCHUpdates an existing tag.
Use this resource to delete multiple tag associations at one timedeleteTagsPOSTUse this resource to delete multiple tag associations at one time.
Platform11
Creates or imports an encryption key. To create a key, the data at rest encryption feature must be enabledcreateAnEncryptionKeyPOSTCreates or imports an encryption key.
Deletes an encryption keydeleteAnEncryptionKeyDELETEDeletes an encryption key.
Queue the rotation of an encryption keyrotateAnEncryptionKeyPUTQueue the rotation of an encryption key.
Retrieve a list of endpoints for Marketing Cloud Engagement services, such as the authentication, REST API, SOAP APIgetEndpointsGETRetrieve a list of endpoints for Marketing Cloud Engagement services, such as the authentication, REST API, SOAP API, and FTP servers.
Retrieve all of the encryption keys associated with an account. To retrieve this data, the data at rest encryptiongetEncryptionKeysGETRetrieve all of the encryption keys associated with an account.
Retrieve an endpoint URL for a specific service, such as REST or SOAP APIgetEndpointGETRetrieve an endpoint URL for a specific service, such as REST or SOAP API.
Retrieve an existing encryption key by providing its IDretrieveAnEncryptionKeyByIdGETRetrieve an existing encryption key by providing its ID.
Retrieve and create an RSA 4096 wrapping keygetAWrappingKeyGETThis feature isn't enabled by default.
Retrieve information about settings that apply to your accountgetAccountSettingsGETRetrieves the status of the Einstein Data Pooling business rule in Marketing Cloud Engagement.
Retrieves information about the key types and key lengths that your account supports. To retrieve this information,getKeyTypesGETRetrieves information about the key types and key lengths that your account supports.
Returns information about an authentication tokengetAuthenticationTokenInformationGETReturns information about an authentication token.
Push27
Broadcast a push message to all users of a push-enabled appsendAMessageToAllUsersPOSTBroadcast a push message to all users of a push-enabled app.
Create a new geofenced or beacon-based locationcreateALocationPOSTCreate a new geofenced or beacon-based location.
Create a push messagecreateAPushMessagePOSTRequired Permission Scope
Delete a push message in your accountdeleteAPushMessageDELETEDelete a push message in your account.
Delete a specific app key by specifying its valuedeleteAnAppKeyDELETEDelete a specific app key by specifying its value.
Delete a specific location by providing its IDdeleteALocationDELETEDelete a specific location by providing its ID.
Delete the custom keys for an app. A successful deletion request removes all of the keys for the appdeleteAppKeysDELETEDelete the custom keys for an app.
Modify the details of an existing locationupdateALocationPUTModify the details of an existing location.
Refresh a list of recipients in MobilePushrefreshAListPOSTThis POST request doesn't require a request body.
Retrieve a list of all applications in an accountgetAppsGETRetrieve a list of all applications in an account.
Retrieve a list of custom keys for an appgetAppKeysGETRetrieve a list of custom keys for an app.
Retrieve all locations in your accountgetLocationsGETRetrieve all locations in your account.
Retrieve all push messages in your accountgetPushMessagesGETRequired Permission Scope
Retrieve details of a specific locationgetALocationGETRetrieve details of a specific location.
Retrieve information about a specific app by providing its IDgetAnAppByIdGETRetrieve information about a specific app by providing its ID.
Retrieve the status of a MobilePush list refresh requestgetListRefreshStatusGETRetrieve the status of a MobilePush list refresh request.
Retrieve the status of push messages that were sent to contacts based on their tagsgetMessagetagDeliveryStatusGETRetrieve the status of push messages that were sent to contacts based on their tags.
Retrieve the status of push messages that were sent to contacts who are on a MobilePush listgetMessagelistDeliveryStatusGETRetrieve the status of push messages that were sent to contacts who are on a MobilePush list.
Retrieve the status of push messages that were sent to specific users of a mobile appgetMessagecontactDeliveryStatusGETRetrieve the status of push messages that were sent to specific users of a mobile app.
Retrieve the status of push messages that were sent to users of an appgetMessageappDeliveryStatusGETRetrieve the status of push messages that were sent to users of an app.
Retrieves a single push message in your accountgetAPushMessageByIdGETRetrieves a single push message in your account.
Send a batch of push messages to specific users by specifying tags or device tokenssendABatchMessagePOSTSend a batch of push messages to specific users by specifying tags or device tokens.
Send a push message to all contacts in a MobilePush listsendAMessageToAListPOSTSend a push message to all contacts in a MobilePush list.
Send a push message to all users of a push-enabled app who have specific tagssendAMessageToTaggedUsersPOSTThe request body must include the inclusionTags or exclusionTags array, or both.
Send a push message to specific users of an app by specifying their device tokens or subscriber keyssendAMessageToSpecificDevicesPOSTSend a push message to specific users of an app by specifying their device tokens or subscriber keys.
Update the content or details of a push messageupdateAPushMessagePUTUpdate the content or details of a push message.
Update the custom keys for an app. When you update the keys for an app, the existing keys are removed and replacedupdateAppKeysPUTUpdate the custom keys for an app.
Security4
Delete HTTP Security HeadersdeleteHttpSecurityHeadersDELETEDelete HTTP Security Headers
Get All HTTP Security HeadersgetAllHttpSecurityHeadersGETGet All HTTP Security Headers
Get HTTP Security HeadersgetHttpSecurityHeadersGETGet HTTP Security Headers
Update HTTP Security HeadersupdateHttpSecurityHeadersPOSTUpdate HTTP Security Headers
SMS21
DELETE /sms/v1/keyword/{keywordId}deleteKeywordViaKeywordIdDELETEDELETE /sms/v1/keyword/{keywordId}
DELETE /sms/v1/keyword/{keyword}/{longCode}deleteKeywordViaKeywordLongCodeDELETEDELETE /sms/v1/keyword/{keyword}/{longCode}
DELETE /sms/v1/keyword/{keyword}/{shortCode}/{countryCode}deleteKeywordViaKeywordShortCodeCountryCodeDELETEDELETE /sms/v1/keyword/{keyword}/{shortCode}/{countryCode}
Generates a .csv file that contains information regarding SMS message delivery for a specific MessageList.importSendDeliveryReportPOSTGenerates a .csv file that contains information regarding SMS message delivery for a specific MessageList.
GET /sms/v1/automation/importSend/{tokenid}/statusimportSendStatusGETGET /sms/v1/automation/importSend/{tokenid}/status
GET /sms/v1/contacts/queueImport/{id}/status/{tokenId}getContactImportStatusGETGET /sms/v1/contacts/queueImport/{id}/status/{tokenId}
GET /sms/v1/messageContact/{messageId}/history/{tokenId}/mobileNumber/{mobileNumber}getMessageContactHistoryGETGET /sms/v1/messageContact/{messageId}/history/{tokenId}/mobileNumber/{mobileNumber}
GET /sms/v1/queueMO/deliveries/{tokenId}getQueueMODeliveryGETGET /sms/v1/queueMO/deliveries/{tokenId}
GET /sms/v1/queueMO/history/{tokenId}getQueueMOHistoryGETGET /sms/v1/queueMO/history/{tokenId}
POST /sms/v1/automation/importSendimportSendPOSTPOST /sms/v1/automation/importSend
POST /sms/v1/contacts/queueImport/{id}queueContactImportPOSTPOST /sms/v1/contacts/queueImport/{id}
POST /sms/v1/contacts/refreshList/{id}postRefreshSMSAudiencePOSTPOST /sms/v1/contacts/refreshList/{id}
POST /sms/v1/contacts/subscriptionscontactsSubscriptionsPOSTPOST /sms/v1/contacts/subscriptions
POST /sms/v1/keywordcreateKeywordPOSTPOST /sms/v1/keyword
POST /sms/v1/messageContact/{id}/sendpostMessageContactSendPOSTPOST /sms/v1/messageContact/{id}/send
POST /sms/v1/messageList/{id}/deliveryReport/{tokenId}messageListDeliveryReportPOSTPOST /sms/v1/messageList/{id}/deliveryReport/{tokenId}
POST /sms/v1/messageList/{id}/sendpostMessageListPOSTPOST /sms/v1/messageList/{id}/send
POST /sms/v1/queueMOpostQueueMOPOSTPOST /sms/v1/queueMO
Retrieves the overall delivery status of a message to a contact and the standard SMS status codes and descriptionsgetMessageContactDeliveryGETRetrieves the overall delivery status of a message to a contact and the standard SMS status codes and descriptions.
Retrieves the refresh list statusgetRefreshSMSAudienceGETRetrieves the refresh list status.
Returns status for a message sent to a group of mobile numbersgetMessageListGETReturns status for a message sent to a group of mobile numbers.
Transactional Messaging - Email11
Create a long-living send definition object that references the email template, subscriber list, sending optionscreateEmailSendDefinitionPOSTA send definition is referenced in the transactional messaging API when you send a triggered message to recipients.
Delete an email send definition by specifying its keydeleteEmailSendDefinitionByKeyDELETEDelete an email send definition by specifying its key.
Deletes the queue for a send definitiondeleteQueueMetricsDELETEDeletes the queue for a send definition.
Get a list of all email send definitions. You can filter and sort the results by including query parametersretrieveAllEmailSendDefinitionsGETGet a list of all email send definitions.
Get the content of an email send definition by specifying its keyretrieveEmailSendDefinitionByKeyGETGet the content of an email send definition by specifying its key.
Get the queue metrics for an email send definition by specifying its keyretrieveQueueMetricsGETGet the queue metrics for an email send definition by specifying its key.
Gets a paginated list of messages that weren't sent, ordered from oldest to newestretrieveUnsentMessagesGETGets a paginated list of messages that weren't sent, ordered from oldest to newest.
Retrieves the send status for an emailretrieveStatusOfAnEmailMessageGETRequests to this endpoint are rate-limited.
Send an email to a single recipient by specifying a message keysendEmailMessageToASingleRecipientPOSTSend an email to a single recipient by specifying a message key.
Send an email to multiple recipients by specifying a send definition. You can send messages to up to 2,000 recipientssendEmailMessageToMultipleRecipientsPOSTSend an email to multiple recipients by specifying a send definition.
Update an email send definition by specifying its keyupdateEmailSendDefinitionPATCHUpdate an email send definition by specifying its key.
Transactional Messaging - OTT8
Create an OTT send definition used to make final message sendscreateAnOttSendDefinitionPOSTCreate an OTT send definition used to make final message sends.
Delete a message definition. You can't restore a deleted definition. The deleted definition is archived, and a deletedeleteAnOttSendDefinitionByKeyDELETEDelete a message definition.
Download rich media inbound messagesdownloadRichMediaInboundMessagesGETDownload rich media inbound messages using the media 'id' received in the ENS notification.
Get a list of OTT send definitions. The number of records that the method returns is based on the $pageSize and $pagegetAllSendDefinitionsGETGet a list of OTT send definitions.
Get message send status for a recipientgetMessageSendStatusForRecipientGETThis method returns the send status for a message.
Retrieve the send definition configuration details for a definition keygetSendDefinitionByDefinitionKeyGETRetrieve the send definition configuration details for a definition key.
Send a message to multiple recipients using a send definitionsendMessageToMultipleRecipientsPOSTYou can provide a messageKey in the request; otherwise, the messageKey is automatically generated in the response.
Update an OTT send definition using the definition key. You can update only the status of the send definitionupdateAnOttSendDefinitionPATCHUpdate an OTT send definition using the definition key.
Transactional Messaging - Push7
Create a transactional push send definitioncreateAPushSendDefinitionPOSTRequired Permission Scope
Delete a transactional push send definitiondeleteAPushSendDefinitionDELETERequired Permission Scope
Retrieve a list of transactional push send definitions in your accountgetPushSendDefinitionsGETRequired Permission Scope
Retrieve details of a transactional push send definitiongetPushSendDefinitionDetailsGETRequired Permission Scope
Retrieve the status of a transactional push notificationgetTransactionalPushNotificationStatusGETRequired Permission Scope
Send a transactional push notification to one or more subscribers or devicessendATransactionalPushNotificationPOSTRequired Permission Scope
Update a transactional push send definitionupdateAPushSendDefinitionPATCHRequired Permission Scope
Transactional Messaging - SMS11
Creates an SMS send definitioncreateSMSSendDefinitionPOSTCreates an SMS send definition.
DELETE /messaging/v1/sms/definitions/{definitionKey}deleteSMSMessageDefinitionDELETEDELETE /messaging/v1/sms/definitions/{definitionKey}
Deletes the queue for a send definition. The send definition must be inactivedeleteSMSQueuedMessagesForDefinitionDELETEDeletes the queue for a send definition.
GET /messaging/v1/sms/definitionsgetSMSDefinitionsGETGET /messaging/v1/sms/definitions
Gets a paginated list of messages that weren't sent, ordered from oldest to newestgetSMSMessagesNotSentGETGets a paginated list of messages that weren't sent, ordered from oldest to newest.
PATCH /messaging/v1/sms/definitions/{definitionKey}updateSMSMessageDefinitionPATCHPATCH /messaging/v1/sms/definitions/{definitionKey}
Retrieves metrics for the messages associated with a send definition, including messages that haven't been processedgetSMSQueueMetricsForDefinitionGETRetrieves metrics for the messages associated with a send definition, including messages that haven't been processed yet.
Retrieves the send definition configuration details for a definition keygetSMSSendDefinitionGETRetrieves the send definition configuration details for a definition key.
Retrieves the send status for an SMS messagegetSMSSendStatusForRecipientGETRetrieves the send status for an SMS message.
Sends a message to a single recipient using a send definitionsendSMSMessageSingleRecipientPOSTSends a message to a single recipient using a send definition.
Sends an SMS message to multiple recipients using a send definitionsendSMSMessageMultipleRecipientsPOSTSends an SMS message to multiple recipients using a send definition.
Workflow Teams4
Creates a user role to assign to a workflow rolecreateWorkflowTeamUserPOSTCreates a user role to assign to a workflow role.
GET /hub/v1/workflowteams/{objecttype}workflowTeamsGETGET /hub/v1/workflowteams/{objecttype}
POST /hub/v1/workflowitems/{workflowItemid}/transitionstransitionWorkflowItemPOSTPOST /hub/v1/workflowitems/{workflowItemid}/transitions
Removes a user assigned to a workflow roledeleteWorkflowTeamuserDELETERemoves a user assigned to a workflow role.