Unified Executions (POST) | Loyalty Management Developer Guide

Use POST to process unified loyalty execution with cart details and run settings. When isSimulation is true, the API returns simulation results without creating records. The response uses the same output representation as transaction journal execution.

Resource

1/connect/loyalty/unified-executions

Resource Example

1https://yourInstance.salesforce.com/services/data/v68.0/connect/loyalty/unified-executions

Available Version

68.0

HTTP Methods

POST

Request Parameters for POST

Parameter Name	Type	Description	Required or Optional	Available Version
`ruleLibraryApiName`	String	API name of an active rule library that's used to evaluate promotions and execute loyalty processing. If omitted, the API uses the active rule library.	Optional	68.0

Request Body for POST

JSON Example

1{
2  "cart": {
3    "cartDetails": [
4      {
5        "loyaltyProgramId": "0lpxx000000003FAAQ",
6        "journalTypeId": "0lExx000000004rEAA",
7        "loyaltyProgramMemberId": "0lMxx000000001dEAA",
8        "activityStartDate": "2026-07-14T12:45:19Z",
9        "activityDate": "2026-07-14T12:45:19Z",
10        "currencyISOCode": "USD",
11        "transactionAmount": "499",
12        "cartLineDetails": [
13          {
14            "cartLineProductId": "01txx0000006i44AAA",
15            "cartLineProductCode": "Burger123",
16            "cartLineProductStockKeepingUnit": "AnySKU",
17            "cartLineItemQuantity": 2,
18            "cartLineItemAmount": 99
19          },
20          {
21            "cartLineProduct": "Coke",
22            "cartLineProductStockKeepingUnit": "AnySKU",
23            "cartLineItemQuantity": 10,
24            "cartLineItemAmount": 400
25          }
26        ]
27      }
28    ]
29  },
30  "runSetting": {
31    "isSimulation": true
32  }
33}

Properties

Name	Type	Description	Required or Optional	Available Version
`cart`	Map	Cart payload that contains a `cartDetails` array. Each cart detail includes loyalty program, member, journal type, activity date, currency, transaction amount, and cart line item fields used to evaluate promotions and execute loyalty processing. The cart must include at least one cart detail.	Required	68.0
`runSetting`	Execution Details Input	Run settings for the unified execution, including whether to run in simulation mode.	Optional	68.0

Response Body for POST

Loyalty Engine Realtime