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
- In Neblex open Connect › Connections and click New Connection.
- Search for Marketing Cloud and give the connection a clear name.
- Fill in the fields. Secret values are encrypted and never shown again.
- 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.
| Field | What to enter |
|---|---|
| SubdomainRequired | The tenant subdomain of your REST and Authentication Base URIs: the part before .rest.marketingcloudapis.com. |
| Token endpointRequired | Your Authentication Base URI followed by v2/token, for example https://YOUR_SUBDOMAIN.auth.marketingcloudapis.com/v2/token. |
| Client IDRequired | Client ID of the server-to-server API integration in Installed Packages. |
| Client secretRequiredSecret | Client secret of the API integration. |
| ScopeOptional | Optional space-separated scopes to request; empty requests every scope the integration has. |
| Business unitOptional | Optional token request settings. |
| Token requestRequired | Marketing Cloud takes the client credentials in a JSON token request body. |
Use it in a flow
- Open a flow, open the node library and search for Marketing Cloud.
- Drag it onto the canvas and choose an Operation and your connection.
- Map the operation's fields from earlier steps, or click Map with Matt.
- 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 addressvalidateEmail | POST | Processes 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 workflowcreateApprovalItem | POST | Creates an approval item and an associated a workflow item. |
GET /hub/v1/approvals-v2/settingsgetApprovalSettings | GET | GET /hub/v1/approvals-v2/settings |
GET /hub/v1/approvals-v2/{id}/rolesgetApprovalRoles | GET | GET /hub/v1/approvals-v2/{id}/roles |
Modifies the name, description, and deadline of an existing approval item. The response contains detailsmodifyApprovalItem | PATCH | Modifies the name, description, and deadline of an existing approval item. |
PATCH /hub/v1/approvals-v2/settingsupdateApprovalSettings | PATCH | PATCH /hub/v1/approvals-v2/settings |
Retrieves all approval items that belong to the current user. To filter the results, use the request parametersgetApprovalItems | GET | Retrieves 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 workflowgetApprovalItem | GET | Retrieves an approval item that belongs to the current user. |
Assets18
Archive an assetarchiveAsset | PATCH | Archive an asset. |
Create assetcreateAsset | POST | Creates a new asset. |
Create categorycreateCategory | POST | Creates a category in Content Builder. |
Delete an assetdeleteAsset | DELETE | Deletes an asset. |
Delete categorydeleteCategory | DELETE | Deletes a Content Builder category. |
Get asset by IDgetAsset | GET | Retrieves an asset by its ID. |
Get asset filegetFile | GET | Gets the binary file for an asset. |
Get assets by advanced querygetAssetsAdvancedQuery | POST | Use an advanced query to retrieve a collection of assets. |
Get assets by simple filtergetAssetsSimpleQuery | GET | Retrieve a collection of assets by applying basic filters and sorting rules. |
Get categoriesgetCategories | GET | Returns one or more Content Builder categories that are owned by or reside in your MID. |
Get category by IDgetCategory | GET | Returns one Content Builder category by ID. |
Get channel viewgetChannelView | GET | Returns the compiled HTML for a requested channel view of an asset. |
Get default salutationsgetSalutations | GET | Retrieves the default header and footer for an account. |
Get email salutationsgetHeaderAndFooter | GET | Retrieves the header and footer of an email asset by specifying the asset ID. |
Patch an assetpatchAsset | PATCH | Modify the properties of an asset deleted in the last 30 days. |
Restore assetrestoreAsset | PATCH | Restore an asset hidden by a prior archive operation, and make it available again for queries, triggered sends, journeys, and other operations. |
Update an assetupdateAsset | PUT | Modify the properties of an existing asset. |
Update categoryupdateCategory | PUT | Updates a Content Builder category. |
Audits2
GET /data/v1/audit/auditEventsgetAuditEvents | GET | Retrieve logged Audit Trail audit events for the current account and its child accounts. |
GET /data/v1/audit/securityEventsgetSecurityEvents | GET | Retrieve logged Audit Trail security events for the current account and its children. |
Auth2
Get base URLsgetBaseUrls | GET | Obtain the base URLs for the Marketing Cloud Auth and REST APIs. |
Get user informationgetUserInfo | GET | Retrieves 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 IDupdateAutomationFileTrigger | PATCH | Required Scopes |
Activate or deactivate an automation file trigger by providing its keyupdateAutomationFileTriggerByKey | PATCH | Required Scopes |
Activate or Deactivate an Automation TriggerupdateAutomationTrigger | PATCH | Required scopes |
Add a file transfer activity to the queue for processingstartFileTransferActivity | POST | Add a file transfer activity to the queue for processing. |
Check the status for a specified Trigger API requestIDgetTriggerStatus | GET | Note 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 activitycreateFileTransferActivity | POST | Create a file transfer activity. |
Create an automation using existing Automation Studio activitiescreateAutomation | POST | Required Scopes |
Delete a specific file transfer activity by providing its IDdeleteFileTransferActivity | DELETE | Delete a specific file transfer activity by providing its ID. |
Retrieve a list of all automations in the accountgetAutomations | GET | Required Scopes |
Retrieve a list of all file transfer activities in the accountgetFileTransferActivities | GET | Retrieve a list of all file transfer activities in the account. |
Retrieve a list of all folders in the accountgetAutomationFolders | GET | Required Scopes |
Retrieve a list of all FTP locations in the accountgetFtpLocations | GET | Required Scopes |
Retrieve a list of automation script activitiesgetAutomationScriptActivities | GET | Required Scopes |
Retrieve a specific automation by providing its IDgetAutomation | GET | Required Scopes |
Retrieve a specific file transfer activity by providing its IDgetFileTransferActivity | GET | Retrieve a specific file transfer activity by providing its ID. |
Run a script activity one timeexecuteScriptActivity | POST | Required Scopes |
Run all activities in an automation one time by specifying its external keyexecuteAutomationActivitiesByKey | POST | Required Scopes |
Run all activities in an automation one time by specifying its IDexecuteAutomationActivities | POST | Required Scopes |
Start an automation that uses a trigger start sourceexecuteTriggeredAutomation | POST | When 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 IDupdateFileTransferActivity | PATCH | Update a file transfer activity by providing its ID. |
Bulk Data Ingest9
Complete data staging for a bulk data ingest jobcompleteDataStaging | POST | Required Scopes |
Create a bulk data ingestion jobcreateBulkIngestJob | POST | Create a bulk data ingestion job. |
Delete the job definition of a bulk data ingest jobdeleteBulkIngestJobDefinition | DELETE | Deletes an active bulk data ingest job. |
Get a summary for a completed bulk data ingestion jobgetBulkDataIngestJobSummary | GET | View a summary of a completed bulk data ingest job. |
Get the job definition of a bulk data ingest jobgetBulkIngestJobDefinition | GET | Get the job definition of a bulk data ingest job. |
Get the validation results of a bulk data ingest jobgetBulkDataIngestJobValidationResults | GET | Get the validation results for a completed bulk data ingest job. |
Get the validation summary of a bulk data ingest jobgetBulkDataIngestJobValidationSummary | GET | Get a validation summary for a completed bulk data ingest job. |
Stage data for a bulk data ingest jobstageDataForBulkIngestJob | PUT | Stage data to import in a bulk job. |
Update the job definition of an existing bulk data ingest jobupdateBulkIngestJobDefinition | PATCH | Update the job definition of a bulk data ingest job. |
Campaigns9
Associate an asset with a campaignaddAssetToCampaign | POST | Required permission scope: Campaign Write |
Create a campaigncreateCampaign | POST | Required permission scope: Campaign Write |
Delete a campaigndeleteCampaign | DELETE | Required permission scope: Campaign Write |
Remove an association between an asset and a campaignremoveAssetFromCampaign | DELETE | Required permission scope: Campaign Write |
Retrieve a list of assets that are associated with a campaigngetCampaignAssets | GET | Required permission scope: Campaign Read |
Retrieve a list of campaigns in your accountgetCampaigns | GET | Required permission scope: Campaign Read |
Retrieve information about a single campaigngetCampaign | GET | Required permission scope: Campaign Read |
Retrieve information about a specific asset that is associated with a campaigngetCampaignAsset | GET | Required permission scope: Campaign Read |
Update a campaignupdateCampaign | PATCH | Required permission scope: Campaign Write |
Chat Messaging5
GET /ott/v1/registration/{platform}ottRetrieveRegistrationCollection | GET | GET /ott/v1/registration/{platform} |
GET /ott/v1/registration/{platform}/{ottPropertyId}ottRetrieveRegistrationProperty | GET | GET /ott/v1/registration/{platform}/{ottPropertyId} |
GET /ott/v1/send/{messageId}ottRetrieveSentMessage | GET | GET /ott/v1/send/{messageId} |
Register a property for a specific OTT platform. If you try to register an existing Messenger Page ID or LINE ChannelottRegisterProperty | POST | Register a property for a specific OTT platform. |
Send an OTT message to the recipient. Supported OTT networks are Facebook Messenger and LINEottSendMessageToRecipient | POST | Send an OTT message to the recipient. |
Contacts40
Adds consent management information to contact records by contact ID for data protection and privacy concernsaddContactPreferencesById | POST | Adds 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 checkdeleteByContactIDs | POST | Asynchronously 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 checkdeleteByContactKeys | POST | Asynchronously deletes a contact when provided with its contact key. |
Creates or returns a contact using the Contact Key and Contact Type provided in the payloadestablishContactsDetail | POST | Creates 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 OperationIDdeleteByListReference | POST | Deletes contacts based on specified list reference value. |
GET /contacts/v1/contacts/actions/delete/status?operationID=contactsDeleteStatus | GET | GET /contacts/v1/contacts/actions/delete/status?operationID= |
GET /contacts/v1/contacts/actions/restrict/status?operationID=contactsRestrictStatus | GET | GET /contacts/v1/contacts/actions/restrict/status?operationID= |
GET /contacts/v1/contacts/analytics/deleterequests/summarycontactsDeleteRequestsSummary | GET | GET /contacts/v1/contacts/analytics/deleterequests/summary |
GET /contacts/v1/contacts/deleteOperationsgetListOfContactDeleteOperations | GET | GET /contacts/v1/contacts/deleteOperations |
GET /contacts/v1/contacts/id:{contactId}/PreferencesgetContactPreferencesById | GET | GET /contacts/v1/contacts/id:{contactId}/Preferences |
GET /contacts/v1/contacts/key:{contactKey}/PreferencesgetContactPreferencesByKey | GET | GET /contacts/v1/contacts/key:{contactKey}/Preferences |
GET /contacts/v1/customObject/{id}/isUsedInContactsgetCustomObject | GET | GET /contacts/v1/customObject/{id}/isUsedInContacts |
GET /contacts/v1/customobjectfield/{id}/relationshipsretrieveCustomObjectFieldRelationships | GET | GET /contacts/v1/customobjectfield/{id}/relationships |
GET /contacts/v1/schemaschemasCollection | GET | GET /contacts/v1/schema |
GET /contacts/v1/schemas/{schemaId}/attributeGroupsretrieveAttributeGroups | GET | GET /contacts/v1/schemas/{schemaId}/attributeGroups |
GET /contacts/v1/schemas/{schemaId}/attributeGroups/{id}retrieveAttributeGroupsID | GET | GET /contacts/v1/schemas/{schemaId}/attributeGroups/{id} |
POST /contacts/v1/addresses/search/{attributeName}fetchContactsAddressesBySearchCriteria | POST | POST /contacts/v1/addresses/search/{attributeName} |
POST /contacts/v1/attributeGroups/populationcreatePopulationAttributeGroup | POST | POST /contacts/v1/attributeGroups/population |
POST /contacts/v1/attributeSets/{id}attributeSetsDataIDInsert | POST | POST /contacts/v1/attributeSets/{id} |
POST /contacts/v1/contactscreateContacts | POST | POST /contacts/v1/contacts |
POST /contacts/v1/contacts/actions/delete/configSettingscontactsDeleteConfigStatus | POST | POST /contacts/v1/contacts/actions/delete/configSettings |
POST /contacts/v1/contacts/actions/delete/optionsgetDeleteOptions | POST | POST /contacts/v1/contacts/actions/delete/options |
POST /contacts/v1/contacts/actions/restrict?type=idsrestrictContactId | POST | POST /contacts/v1/contacts/actions/restrict?type=ids |
POST /contacts/v1/contacts/actions/restrict?type=keysrestrictContactKey | POST | POST /contacts/v1/contacts/actions/restrict?type=keys |
POST /contacts/v1/contacts/actions/restrict?type=listReferencerestrictContactListreference | POST | POST /contacts/v1/contacts/actions/restrict?type=listReference |
POST /contacts/v1/contacts/preferencesaddContactPreferences | POST | POST /contacts/v1/contacts/preferences |
POST /contacts/v1/contacts/preferences/search?ReferenceType={ReferenceType}searchContactPreferencesByReferenceType | POST | POST /contacts/v1/contacts/preferences/search?ReferenceType={ReferenceType} |
POST /contacts/v1/operations/delete/{operationID}/retryretryContactDelete | POST | POST /contacts/v1/operations/delete/{operationID}/retry |
POST /contacts/v1/operations/restrict/{operationID}/retryretryContactRestrict | POST | POST /contacts/v1/operations/restrict/{operationID}/retry |
POST /interaction/v1/interactions/contactexitcontactExitRequest | POST | POST /interaction/v1/interactions/contactexit |
POST /interaction/v1/interactions/contactexit/statuscontactExitStatus | POST | POST /interaction/v1/interactions/contactexit/status |
Provides a list of journeys and journey versions for a list of contact keyscontactMembershipRequest | POST | Provides 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 needretrieveContactKey | POST | Retrieve the contact key for one or more email addresses. |
Retrieve the number of contacts who meet a set of search criteriafetchContactsAddressesCountSearchCriteria | POST | Retrieve 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 nameattributeSetsDataName | GET | Retrieves 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 modelretrieveAllAttributeSetDefinitions | GET | Retrieves all attribute set definition from your contact data model. |
Retrieves an attribute set definition from your contact data modelretrieveAttributeSetDefinitions | GET | Retrieves an attribute set definition from your contact data model. |
Retrieves details of contact delete requests for a date rangecontactsDeleteRequestsDetails | GET | Retrieves 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 nameattributeSetsDataIDUpdate | PATCH | Updates a collection of attribute value containers or the data rows of a specified attribute set by ID or name. |
Updates a contact recordupdateContacts | PATCH | Updates a contact record. |
Data Extension Data3
Retrieve data from a data extension by providing its external keygetDataByKey | GET | Retrieve data from a data extension by providing its external key. |
Retrieve data from a data extension by providing its IDgetData | GET | Retrieve 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 $orderbygetDataByRequestToken | GET | Retrieve data from a data extension by providing the request token. |
Data Extension Imports4
Get import row-level validation details by IDgetValidationDetailsOfAOneTimeDataImport | GET | Returns 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 definitionqueueAndStartAOneTimeDataImport | POST | Perform 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 finishesgetValidationSummaryForADataImport | GET | Retrieve 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 (SuccessgetStatusOfAOneTimeDataImport | GET | Returns 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 asynchronouslyinsertRows | POST | For 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'tupsertRows | PUT | For 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 extensiongetRequestResults | GET | For 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 extensiongetRequestStatus | GET | For 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 operationincrementColumnValue | PUT | Increase 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 operationincrementColumnValueByKey | PUT | Increase 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 extensionupsertRowsetByKey | POST | Upsert 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 extensionupsertRowset | POST | Upsert 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 extensionupsertRowByKey | PUT | The 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 extensionupsertRow | PUT | Specify the primary key and value in the URL path. |
Data Extensions10
Creates a data extensioncreateDataExtension | POST | Required Scopes |
Deletes a data extensiondeleteDataExtension | DELETE | Required Scopes |
Deletes all of the data in a data extensionclearDataExtensionData | POST | Required Scopes |
Inserts a new field into a data extensioncreateDataExtensionField | POST | Required Scopes |
Retrieves a list of data extensions based on the ID of the parent categorygetDataExtensionsByCategoryId | GET | Required Scopes |
Retrieves a list of data extensions that match a search stringgetDataExtensions | GET | Required Scopes |
Retrieves a list of fields in a data extensiongetDataExtensionFields | GET | Required Scopes |
Retrieves information about the specified data extension by providing its IDgetDataExtension | GET | Required Scopes |
Update the fields in a data extensionupdateDataExtension | PATCH | Required Scopes |
Updates a field in a data extensionupdateDataExtensionField | PATCH | Required Permission Scope |
Domain Verification8
Create a domaincreateDomain | POST | Creates an email or domain record. |
Create domains in bulkcreateDomainsBulk | POST | Creates multiple sender email address records. |
Delete an address or domaindeleteDomain | POST | Deletes an email address or domain record. |
Get domainsgetDomains | GET | Retrieves 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 unitspushRegisteredDomains | POST | Makes one or more registered domains available in other business units (BUs) that share an Enterprise ID (EID). |
Register an email domainregisterDomain | POST | Registers a new domain to use for sending email. |
Retrieve a domain verification tokenretrieveDomainVerificationToken | POST | Retrieves a verification token for a domain. |
Update an address or domainupdateDomain | POST | Updates 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 whichcreateSubscription | POST | Creates a single subscription. |
DELETE /platform/v1/ens-callbacks/{callbackId}deleteCallback | DELETE | DELETE /platform/v1/ens-callbacks/{callbackId} |
DELETE /platform/v1/ens-subscriptions/{subscriptionId}deleteSubscription | DELETE | DELETE /platform/v1/ens-subscriptions/{subscriptionId} |
GET /platform/v1/ens-callbacks/{callbackId}getCallback | GET | GET /platform/v1/ens-callbacks/{callbackId} |
GET /platform/v1/ens-subscriptions-by-cb/{callbackId}getAllSubscriptionsForCallback | GET | GET /platform/v1/ens-subscriptions-by-cb/{callbackId} |
GET /platform/v1/ens-subscriptions/{subscriptionId}getSubscription | GET | GET /platform/v1/ens-subscriptions/{subscriptionId} |
PUT /platform/v1/ens-callbacksupdateCallback | PUT | PUT /platform/v1/ens-callbacks |
PUT /platform/v1/ens-subscriptionsupdateSubscription | PUT | PUT /platform/v1/ens-subscriptions |
Regenerates a signature key for a given callback. Regenerating a signature key deactivates the existing keyregenerateSignatureKey | PUT | Regenerates 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 itcreateCallback | POST | Registers a new callback to receive event notifications. |
Retrieves details about all registered callbacksgetAllCallbacks | GET | Retrieves details about all registered callbacks. |
Verifies a callback so that it can receive notificationsverifyCallback | POST | Verifies a callback so that it can receive notifications. |
File Transfer Locations6
Create a new File Transfer Location in your accountcreateAFileTransferLocation | POST | This method creates a new file location. |
Deactivate a file transfer location identified by customerKeydeleteAFileTransferLocation | DELETE | This method deactivates a file location based on a given customer key. |
Get a file transfer location identified by customerKeygetAFileTransferLocation | GET | This method returns a single file location for the given customer key. |
Get all file transfer locations for the current MIDgetAllFileTransferLocations | GET | This 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 customerKeyupdateAFileTransferLocation | PATCH | This method updates a file location based on a given customer key. |
Validate a file transfer location schema passed in request bodyvalidateAFileTransferLocation | POST | This method validates a file location. |
Journeys and Events28
Checks the status of a publicationgetPublishStatus | GET | Checks the status of a publication. |
Create an Event Definition, which contains the name and data schema for an event. The resource uses this keycreateEventDefinition | POST | Create an Event Definition, which contains the name and data schema for an event. |
DELETE /interaction/v1/eventDefinitions/{id}deleteEventDefinition | DELETE | DELETE /interaction/v1/eventDefinitions/{id} |
DELETE /interaction/v1/interactions/{id}deleteInteractionById | DELETE | DELETE /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 youdownloadJourneyHistory | POST | Downloads journey history to a file. |
Enter a batch of subscribers into a journey or release a batch of subscribers from a wait event asynchronouslyenterContactsIntoJourneyInBatches | POST | Enter a batch of subscribers into a journey or release a batch of subscribers from a wait event asynchronously. |
GET /interaction/v1/eventDefinitions/{id}getEventDefinition | GET | GET /interaction/v1/eventDefinitions/{id} |
GET /interaction/v1/interactions/{id}getInteractionById | GET | GET /interaction/v1/interactions/{id} |
GET /interaction/v1/restrestDiscovery | GET | GET /interaction/v1/rest |
Insert subscribers into a journey synchronouslypostEvent | POST | Insert 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, usejourneyPauseByDefinitionKey | POST | Pause 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, usejourneyPauseByDefinitionId | POST | Pause a journey that's currently running by specifying its ID. |
POST /interaction/v1/interactionspostCreateInteraction | POST | POST /interaction/v1/interactions |
Post /interaction/v1/interactions/contactexitinteractionContactExitRequest | POST | Post /interaction/v1/interactions/contactexit |
Post /interaction/v1/interactions/contactexit/statusinteractiveContactExitStatus | POST | Post /interaction/v1/interactions/contactexit/status |
POST /interaction/v1/interactions/publishAsync/{id}?versionNumber={versionNumber}postPublishInteractionById | POST | POST /interaction/v1/interactions/publishAsync/{id}?versionNumber={versionNumber} |
POST /interaction/v1/interactions/resume/key:{definitionKey}?versionNumber={versionNumber}journeyResumeByDefinitionKey | POST | POST /interaction/v1/interactions/resume/key:{definitionKey}?versionNumber={versionNumber} |
POST /interaction/v1/interactions/resume/{definitionID}?versionNumber={versionNumber}journeyResumeByDefinitionId | POST | POST /interaction/v1/interactions/resume/{definitionID}?versionNumber={versionNumber} |
POST /interaction/v1/interactions/stop/{definitionId}?versionNumber={versionNumber}postStopInteractionById | POST | POST /interaction/v1/interactions/stop/{definitionId}?versionNumber={versionNumber} |
Provides an estimate of the amount of time that journey history events trail behind actual journey eventsgetJourneyHistoryDownloadFreshness | GET | Provides an estimate of the amount of time that journey history events trail behind actual journey events. |
Retrieve a collection of event definitionsgetEventDefinitions | GET | Retrieve a collection of event definitions. |
Retrieve a list of journeysgetInteractionCollection | GET | Retrieve a list of journeys. |
Retrieve the status of contacts that were inserted into a journey using the POST method . Use this operationgetStatusOfContacts | GET | Retrieve 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 differentgetInteractionAuditLogByKey | GET | Retrieves 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 actionsgetInteractionAuditLog | GET | Retrieves 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.getJourneyHistoryDownloadEstimate | POST | Returns 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 | ReadputUpdateInteraction | PUT | Updates a journey version. |
Updates an event definition by ID or key. Once an event definition is created, only a few properties can be updated.updateEventDefinition | PUT | Updates an event definition by ID or key. |
Messaging2
GET /messaging/v1/messageDefinitionSends/key:{key}/deliveryRecordsmessageDefinitionSendsDeliveryRecords | GET | GET /messaging/v1/messageDefinitionSends/key:{key}/deliveryRecords |
POST /messaging/v1/messageDefinitionSends/{triggeredSendDefinitionId}/sendmessageDefinitionSends | POST | POST /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 associatedcreateTags | POST | Add 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 tagcreateNestedTags | POST | Creates a tag that can be associated with any object that accepts tagging. |
DELETE /hub/v1/nestedtags/{tagId}deleteNestedTags | DELETE | DELETE /hub/v1/nestedtags/{tagId} |
GET /hub/v1/nestedtagsgetNestedTags | GET | GET /hub/v1/nestedtags |
GET /hub/v1/nestedtags/{tagId}getNestedTagById | GET | GET /hub/v1/nestedtags/{tagId} |
PUT /hub/v1/nestedtags/{tagId}updateNestedTags | PUT | PUT /hub/v1/nestedtags/{tagId} |
Updates an existing tag. Provide only the tag fields to be changedpatchNestedTags | PATCH | Updates an existing tag. |
Use this resource to delete multiple tag associations at one timedeleteTags | POST | Use 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 enabledcreateAnEncryptionKey | POST | Creates or imports an encryption key. |
Deletes an encryption keydeleteAnEncryptionKey | DELETE | Deletes an encryption key. |
Queue the rotation of an encryption keyrotateAnEncryptionKey | PUT | Queue the rotation of an encryption key. |
Retrieve a list of endpoints for Marketing Cloud Engagement services, such as the authentication, REST API, SOAP APIgetEndpoints | GET | Retrieve 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 encryptiongetEncryptionKeys | GET | Retrieve all of the encryption keys associated with an account. |
Retrieve an endpoint URL for a specific service, such as REST or SOAP APIgetEndpoint | GET | Retrieve an endpoint URL for a specific service, such as REST or SOAP API. |
Retrieve an existing encryption key by providing its IDretrieveAnEncryptionKeyById | GET | Retrieve an existing encryption key by providing its ID. |
Retrieve and create an RSA 4096 wrapping keygetAWrappingKey | GET | This feature isn't enabled by default. |
Retrieve information about settings that apply to your accountgetAccountSettings | GET | Retrieves 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,getKeyTypes | GET | Retrieves information about the key types and key lengths that your account supports. |
Returns information about an authentication tokengetAuthenticationTokenInformation | GET | Returns information about an authentication token. |
Push27
Broadcast a push message to all users of a push-enabled appsendAMessageToAllUsers | POST | Broadcast a push message to all users of a push-enabled app. |
Create a new geofenced or beacon-based locationcreateALocation | POST | Create a new geofenced or beacon-based location. |
Create a push messagecreateAPushMessage | POST | Required Permission Scope |
Delete a push message in your accountdeleteAPushMessage | DELETE | Delete a push message in your account. |
Delete a specific app key by specifying its valuedeleteAnAppKey | DELETE | Delete a specific app key by specifying its value. |
Delete a specific location by providing its IDdeleteALocation | DELETE | Delete 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 appdeleteAppKeys | DELETE | Delete the custom keys for an app. |
Modify the details of an existing locationupdateALocation | PUT | Modify the details of an existing location. |
Refresh a list of recipients in MobilePushrefreshAList | POST | This POST request doesn't require a request body. |
Retrieve a list of all applications in an accountgetApps | GET | Retrieve a list of all applications in an account. |
Retrieve a list of custom keys for an appgetAppKeys | GET | Retrieve a list of custom keys for an app. |
Retrieve all locations in your accountgetLocations | GET | Retrieve all locations in your account. |
Retrieve all push messages in your accountgetPushMessages | GET | Required Permission Scope |
Retrieve details of a specific locationgetALocation | GET | Retrieve details of a specific location. |
Retrieve information about a specific app by providing its IDgetAnAppById | GET | Retrieve information about a specific app by providing its ID. |
Retrieve the status of a MobilePush list refresh requestgetListRefreshStatus | GET | Retrieve the status of a MobilePush list refresh request. |
Retrieve the status of push messages that were sent to contacts based on their tagsgetMessagetagDeliveryStatus | GET | Retrieve 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 listgetMessagelistDeliveryStatus | GET | Retrieve 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 appgetMessagecontactDeliveryStatus | GET | Retrieve 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 appgetMessageappDeliveryStatus | GET | Retrieve the status of push messages that were sent to users of an app. |
Retrieves a single push message in your accountgetAPushMessageById | GET | Retrieves a single push message in your account. |
Send a batch of push messages to specific users by specifying tags or device tokenssendABatchMessage | POST | Send a batch of push messages to specific users by specifying tags or device tokens. |
Send a push message to all contacts in a MobilePush listsendAMessageToAList | POST | Send 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 tagssendAMessageToTaggedUsers | POST | The 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 keyssendAMessageToSpecificDevices | POST | Send 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 messageupdateAPushMessage | PUT | Update 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 replacedupdateAppKeys | PUT | Update the custom keys for an app. |
Security4
Delete HTTP Security HeadersdeleteHttpSecurityHeaders | DELETE | Delete HTTP Security Headers |
Get All HTTP Security HeadersgetAllHttpSecurityHeaders | GET | Get All HTTP Security Headers |
Get HTTP Security HeadersgetHttpSecurityHeaders | GET | Get HTTP Security Headers |
Update HTTP Security HeadersupdateHttpSecurityHeaders | POST | Update HTTP Security Headers |
SMS21
DELETE /sms/v1/keyword/{keywordId}deleteKeywordViaKeywordId | DELETE | DELETE /sms/v1/keyword/{keywordId} |
DELETE /sms/v1/keyword/{keyword}/{longCode}deleteKeywordViaKeywordLongCode | DELETE | DELETE /sms/v1/keyword/{keyword}/{longCode} |
DELETE /sms/v1/keyword/{keyword}/{shortCode}/{countryCode}deleteKeywordViaKeywordShortCodeCountryCode | DELETE | DELETE /sms/v1/keyword/{keyword}/{shortCode}/{countryCode} |
Generates a .csv file that contains information regarding SMS message delivery for a specific MessageList.importSendDeliveryReport | POST | Generates a .csv file that contains information regarding SMS message delivery for a specific MessageList. |
GET /sms/v1/automation/importSend/{tokenid}/statusimportSendStatus | GET | GET /sms/v1/automation/importSend/{tokenid}/status |
GET /sms/v1/contacts/queueImport/{id}/status/{tokenId}getContactImportStatus | GET | GET /sms/v1/contacts/queueImport/{id}/status/{tokenId} |
GET /sms/v1/messageContact/{messageId}/history/{tokenId}/mobileNumber/{mobileNumber}getMessageContactHistory | GET | GET /sms/v1/messageContact/{messageId}/history/{tokenId}/mobileNumber/{mobileNumber} |
GET /sms/v1/queueMO/deliveries/{tokenId}getQueueMODelivery | GET | GET /sms/v1/queueMO/deliveries/{tokenId} |
GET /sms/v1/queueMO/history/{tokenId}getQueueMOHistory | GET | GET /sms/v1/queueMO/history/{tokenId} |
POST /sms/v1/automation/importSendimportSend | POST | POST /sms/v1/automation/importSend |
POST /sms/v1/contacts/queueImport/{id}queueContactImport | POST | POST /sms/v1/contacts/queueImport/{id} |
POST /sms/v1/contacts/refreshList/{id}postRefreshSMSAudience | POST | POST /sms/v1/contacts/refreshList/{id} |
POST /sms/v1/contacts/subscriptionscontactsSubscriptions | POST | POST /sms/v1/contacts/subscriptions |
POST /sms/v1/keywordcreateKeyword | POST | POST /sms/v1/keyword |
POST /sms/v1/messageContact/{id}/sendpostMessageContactSend | POST | POST /sms/v1/messageContact/{id}/send |
POST /sms/v1/messageList/{id}/deliveryReport/{tokenId}messageListDeliveryReport | POST | POST /sms/v1/messageList/{id}/deliveryReport/{tokenId} |
POST /sms/v1/messageList/{id}/sendpostMessageList | POST | POST /sms/v1/messageList/{id}/send |
POST /sms/v1/queueMOpostQueueMO | POST | POST /sms/v1/queueMO |
Retrieves the overall delivery status of a message to a contact and the standard SMS status codes and descriptionsgetMessageContactDelivery | GET | Retrieves the overall delivery status of a message to a contact and the standard SMS status codes and descriptions. |
Retrieves the refresh list statusgetRefreshSMSAudience | GET | Retrieves the refresh list status. |
Returns status for a message sent to a group of mobile numbersgetMessageList | GET | Returns 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 optionscreateEmailSendDefinition | POST | A 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 keydeleteEmailSendDefinitionByKey | DELETE | Delete an email send definition by specifying its key. |
Deletes the queue for a send definitiondeleteQueueMetrics | DELETE | Deletes the queue for a send definition. |
Get a list of all email send definitions. You can filter and sort the results by including query parametersretrieveAllEmailSendDefinitions | GET | Get a list of all email send definitions. |
Get the content of an email send definition by specifying its keyretrieveEmailSendDefinitionByKey | GET | Get the content of an email send definition by specifying its key. |
Get the queue metrics for an email send definition by specifying its keyretrieveQueueMetrics | GET | Get 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 newestretrieveUnsentMessages | GET | Gets a paginated list of messages that weren't sent, ordered from oldest to newest. |
Retrieves the send status for an emailretrieveStatusOfAnEmailMessage | GET | Requests to this endpoint are rate-limited. |
Send an email to a single recipient by specifying a message keysendEmailMessageToASingleRecipient | POST | Send 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 recipientssendEmailMessageToMultipleRecipients | POST | Send an email to multiple recipients by specifying a send definition. |
Update an email send definition by specifying its keyupdateEmailSendDefinition | PATCH | Update an email send definition by specifying its key. |
Transactional Messaging - OTT8
Create an OTT send definition used to make final message sendscreateAnOttSendDefinition | POST | Create 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 deletedeleteAnOttSendDefinitionByKey | DELETE | Delete a message definition. |
Download rich media inbound messagesdownloadRichMediaInboundMessages | GET | Download 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 $pagegetAllSendDefinitions | GET | Get a list of OTT send definitions. |
Get message send status for a recipientgetMessageSendStatusForRecipient | GET | This method returns the send status for a message. |
Retrieve the send definition configuration details for a definition keygetSendDefinitionByDefinitionKey | GET | Retrieve the send definition configuration details for a definition key. |
Send a message to multiple recipients using a send definitionsendMessageToMultipleRecipients | POST | You 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 definitionupdateAnOttSendDefinition | PATCH | Update an OTT send definition using the definition key. |
Transactional Messaging - Push7
Create a transactional push send definitioncreateAPushSendDefinition | POST | Required Permission Scope |
Delete a transactional push send definitiondeleteAPushSendDefinition | DELETE | Required Permission Scope |
Retrieve a list of transactional push send definitions in your accountgetPushSendDefinitions | GET | Required Permission Scope |
Retrieve details of a transactional push send definitiongetPushSendDefinitionDetails | GET | Required Permission Scope |
Retrieve the status of a transactional push notificationgetTransactionalPushNotificationStatus | GET | Required Permission Scope |
Send a transactional push notification to one or more subscribers or devicessendATransactionalPushNotification | POST | Required Permission Scope |
Update a transactional push send definitionupdateAPushSendDefinition | PATCH | Required Permission Scope |
Transactional Messaging - SMS11
Creates an SMS send definitioncreateSMSSendDefinition | POST | Creates an SMS send definition. |
DELETE /messaging/v1/sms/definitions/{definitionKey}deleteSMSMessageDefinition | DELETE | DELETE /messaging/v1/sms/definitions/{definitionKey} |
Deletes the queue for a send definition. The send definition must be inactivedeleteSMSQueuedMessagesForDefinition | DELETE | Deletes the queue for a send definition. |
GET /messaging/v1/sms/definitionsgetSMSDefinitions | GET | GET /messaging/v1/sms/definitions |
Gets a paginated list of messages that weren't sent, ordered from oldest to newestgetSMSMessagesNotSent | GET | Gets a paginated list of messages that weren't sent, ordered from oldest to newest. |
PATCH /messaging/v1/sms/definitions/{definitionKey}updateSMSMessageDefinition | PATCH | PATCH /messaging/v1/sms/definitions/{definitionKey} |
Retrieves metrics for the messages associated with a send definition, including messages that haven't been processedgetSMSQueueMetricsForDefinition | GET | Retrieves 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 keygetSMSSendDefinition | GET | Retrieves the send definition configuration details for a definition key. |
Retrieves the send status for an SMS messagegetSMSSendStatusForRecipient | GET | Retrieves the send status for an SMS message. |
Sends a message to a single recipient using a send definitionsendSMSMessageSingleRecipient | POST | Sends a message to a single recipient using a send definition. |
Sends an SMS message to multiple recipients using a send definitionsendSMSMessageMultipleRecipients | POST | Sends an SMS message to multiple recipients using a send definition. |
Workflow Teams4
Creates a user role to assign to a workflow rolecreateWorkflowTeamUser | POST | Creates a user role to assign to a workflow role. |
GET /hub/v1/workflowteams/{objecttype}workflowTeams | GET | GET /hub/v1/workflowteams/{objecttype} |
POST /hub/v1/workflowitems/{workflowItemid}/transitionstransitionWorkflowItem | POST | POST /hub/v1/workflowitems/{workflowItemid}/transitions |
Removes a user assigned to a workflow roledeleteWorkflowTeamuser | DELETE | Removes a user assigned to a workflow role. |