ballerinax/salesforce.marketingcloud Ballerina library

Overview

Salesforce Marketing Cloud is a leading digital marketing platform that enables businesses to manage and automate customer journeys, email campaigns, and personalized messaging.

The ballerinax/salesforce.marketingcloud package provides APIs to connect and interact with Salesforce Marketing Cloud API endpoints, supporting a wide range of marketing automation and journey management

Setup guide

This guide explains how to generate an access token in Salesforce Marketing Cloud using an Installed Package.

Step 1: Log in to Marketing Cloud

1. Navigate to your Salesforce Marketing Cloud login page and log in with your credentials.

   

2. Once logged in, click on your username in the top right corner and select Setup from the dropdown menu.

   

Step 2: Create an installed package

1. In the Setup menu, scroll down to the Platform Tools section.

2. Click on Apps and then select Installed Packages.

   

3. Click the New button.

4. Enter a Name and Description for your package (for example, API Integration Package).

5. Click Save.

   

Step 3: Add an API integration component

1. After saving, click on the package you just created to view its details.

   

2. Click on Add Component.

3. Choose API Integration as the component type.

   

4. Select Server-to-Server as the integration type.

   

5. In the list of available scopes, check the required permissions for your integration. For most token generation and API calls, you might need:

   • Read and Write access to Email Studio
   • Access to the REST API
   • Any additional scopes based on your specific use case

   

6. Click Save to add the component.

Step 4: Retrieve the Client ID and Client Secret

On the package detail page, note down the Base URIs, Client ID and Client Secret generated for your integration. These credentials are required to authenticate API calls. If necessary, click on Edit to update any integration details or to add further scopes.

Step 5: Retrieve your user subdomain

Extract the subdomain by taking the portion between https:// and .auth.marketingcloudapis.com in your base URI. For example, from https://mc123456gkz1x4p5b9m4gzx5b9.auth.marketingcloudapis.com/, the subdomain is mc123456gkz1x4p5b9m4gzx5b9.

Step 6: Retrieve your account id if necessary

Navigate to the top right corner of your SFMC account interface, hover over your account name, and the MID will be displayed.

Note: This is only needed if the cloud account has more than one business units.

Quickstart

To use the salesforce.marketingcloud connector in your Ballerina application, modify the .bal file as follows:

Step 1: Import the module

Import the salesforce.marketingcloud module.

import ballerinax/salesforce.marketingcloud;

Step 2: Instantiate a new connector

Create a marketingcloud:ConnectionConfig with the obtained OAuth2.0 tokens and initialize the connector with it.

configurable string clientId = ?;
configurable string clientSecret = ?;
configurable string subDomain = ?;
configurable string accountId = ?;

marketingcloud:Client marketingCloudClient = check new (
    subDomain,
    config = {
        auth: {
            clientId,
            clientSecret,
            accountId
        }
    }
);

Step 3: Invoke the connector operation

Now, utilize the available connector operations.

See all the journeys contact is enrolled in

marketingcloud:ContactMembershipResponse res = 
        check marketingCloudClient->getContactMembership({
            contactKeyList: ["test@example.com"]
        });

Examples

The ballerinax/salesforce.marketingcloud connector provides practical examples illustrating usage in various scenarios. Explore these examples to understand how to capture and process database change events effectively.

1. Seasonal Journey – Shows how to enroll new users into the Seasonal Journey by adding a row to a Data Extension, with checks to prevent enrolling users who are already part of the Rewin Journey.