Skip to main content

Destination

Nexla's bi-directional connectors allow data to flow both to and from any location, making it simple to create a FlexFlow, DB-CDC, Spark ETL, or Replication data flow that sends data to a Salesforce Marketing Cloud location.
salesforce_mktg_cloud_api.png

Salesforce Marketing Cloud

Create a Salesforce Marketing Cloud Destination​

  1. Click the + icon on the Nexset that will be sent to the Salesforce Marketing Cloud destination, and select the Send to Destination option from the menu.

  2. Select the Salesforce Marketing Cloud connector from the list of available destination connectors. Then, select the credential that will be used to connect to your Salesforce Marketing Cloud account, and click Next; or, create a new Salesforce Marketing Cloud credential for use in this flow.

  3. In Nexla, Salesforce Marketing Cloud destinations can be created using pre-built endpoint templates, which expedite destination setup for common Salesforce Marketing Cloud endpoints. Each template is designed specifically for the corresponding Salesforce Marketing Cloud endpoint, making destination configuration easy and efficient.
    • To configure this destination using a template, follow the instructions in Configure Using a Template.

    Salesforce Marketing Cloud destinations can also be configured manually, allowing you to send data to Salesforce Marketing Cloud endpoints not included in the pre-built templates or apply further customizations to exactly suit your needs.
    • To configure this destination manually, follow the instructions in Configure Manually.

Configure Using a Template​

Nexla provides pre-built templates that can be used to rapidly configure destinations to send data to common Salesforce Marketing Cloud endpoints. Each template is designed specifically for the corresponding Salesforce Marketing Cloud endpoint, making destination setup easy and efficient.

  • To configure this destination using a template, select the endpoint to which data will be sent from the Endpoint pulldown menu. Then, click on the template in the list below to expand it, and follow the instructions to configure additional endpoint settings.

    Create Assets

    This endpoint template creates assets in your Salesforce Marketing Cloud account using records from a Nexset. Use this template when you need to create new marketing assets, such as images, documents, or other content assets.

    • This endpoint sends data as JSON in the request body to create assets in your Salesforce Marketing Cloud account. Each record from your Nexset will be sent as a separate API request to create a new asset in Marketing Cloud. The request body should contain the asset data in the format required by the Salesforce Marketing Cloud API.

    This endpoint sends data as JSON in the request body to create assets in your Salesforce Marketing Cloud account. Each record from your Nexset will be sent as a separate API request to create a new asset in Marketing Cloud. The request body should contain the asset data in the format required by the Salesforce Marketing Cloud API, including asset name, type, and other asset properties.

    The asset structure must match the Salesforce Marketing Cloud API's expected format. For detailed information about asset creation, request body formats, and available asset properties, see the Salesforce Marketing Cloud API documentation.

    Create Categories

    This endpoint template creates categories in your Salesforce Marketing Cloud account using records from a Nexset. Use this template when you need to create new asset categories for organizing your marketing assets.

    • This endpoint sends data as JSON in the request body to create categories in your Salesforce Marketing Cloud account. Each record from your Nexset will be sent as a separate API request to create a new category in Marketing Cloud. The request body should contain the category data in the format required by the Salesforce Marketing Cloud API.

    This endpoint sends data as JSON in the request body to create categories in your Salesforce Marketing Cloud account. Each record from your Nexset will be sent as a separate API request to create a new category in Marketing Cloud. The request body should contain the category data in the format required by the Salesforce Marketing Cloud API.

    The category structure must match the Salesforce Marketing Cloud API's expected format. For detailed information about category creation, request body formats, and available category properties, see the Salesforce Marketing Cloud API documentation.

Configure Manually​

Salesforce Marketing Cloud destinations can be manually configured to send data to any valid Salesforce Marketing Cloud API endpoint. Manual configuration provides maximum flexibility for accessing endpoints not covered by pre-built templates or when you need custom API configurations.

Using manual configuration, you can also configure Nexla to automatically send the response received from the Salesforce Marketing Cloud API after each call to a new Nexla webhook data source.

API Method​

  1. To manually configure this destination, select the Advanced tab at the top of the configuration screen.

  2. Select the API method that will be used for calls to the Salesforce Marketing Cloud API from the Method pulldown menu. Salesforce Marketing Cloud API typically uses POST method for creating resources.

Data Format​

  1. Select the format in which the Nexset data will be sent to the Salesforce Marketing Cloud API from the Content Format pulldown menu. Salesforce Marketing Cloud API expects JSON format for all requests.

API Endpoint URL​

  1. Enter the URL of the Salesforce Marketing Cloud API endpoint to which data will be sent in the URL field. This should be the complete URL to your Salesforce Marketing Cloud endpoint, including your subdomain (e.g., https://{subdomain}.rest.marketingcloudapis.com/asset/v1/content/assets). Include any required path parameters in the URL.

Ensure the API endpoint URL is correct and accessible with your current credentials. The Salesforce Marketing Cloud API endpoint URL should point to the endpoint where you want to create assets or categories. The endpoint URL should include your subdomain (from your credential) and the appropriate API path. You can test the endpoint using the Test button after configuring the URL.

Request Body​

  1. Configure the request body that will be sent to the Salesforce Marketing Cloud API. The request body should contain the resource data formatted as JSON, with field names matching the Salesforce Marketing Cloud API's expected structure. The request body format is typically {message.json} to send the entire Nexset data as JSON, or you can construct a custom JSON structure with specific field mappings.

The request body must be valid JSON and must match the Salesforce Marketing Cloud API's expected format for the specific endpoint you're using. Salesforce Marketing Cloud API uses specific structures for different endpoints (assets, categories, etc.). For detailed information about request body formats, available endpoints, and resource structures, see the Salesforce Marketing Cloud API documentation.

Save the Destination​

  1. Once all of the relevant steps in the above sections have been completed, click the Next button to proceed with the rest of the data flow configuration, or click Save to save the destination configuration for later use.