Create Promotions (GET, POST, PUT)

Get rewards based on a product selling model template.

Resource

1/global-promotions-management/promotions

Resource Example

1https://{yourInstance}.salesforce.com/services/data/v68.0/global-promotions-management/promotions

Available Version

66.0

HTTP Methods

GET, POST, PUT

Request and Response Body

This example shows a sample request to create a promotion.

1{
2  "promotionDetails": {
3    "additionalFieldValues": {
4      "attributes": {}
5    },
6    "displayName": "10% off on Cisco Router",
7    "isAutomatic": true,
8    "isEmailActivated": false,
9    "name": "10% off on Cisco Router",
10    "promotionEligibility": {
11      "eligibleCustomerEvents": {},
12      "eligibleEnrollmentPeriod": {
13        "isEnrollmentRequired": false
14      },
15      "eligibleProducts": [
16        {
17          "id": "01txx0000006igmAAA",
18          "name": "Cisco Router",
19          "productType": "SimpleProduct"
20        }
21      ]
22    },
23    "promotionLimits": {},
24    "ruleLibrary": {
25      "id": "9Qsxx0000004H76CAE",
26      "name": "RLMSales"
27    },
28    "startDateTime": "2025-11-01T08:43:00.000Z"
29  },
30  "rules": [
31    {
32      "eventConfiguration": [],
33      "journalSubType": null,
34      "journalSubTypeName": null,
35      "journalType": "Customer Purchase",
36      "priority": 10,
37      "rewardConfiguration": [
38        {
39          "scope": "SimpleProduct",
40          "scopeDetails": [
41            {
42              "name": "Cisco Router",
43              "id": "01txx0000006igmAAA"
44            }
45          ],
46          "doNotDefineRewards": false,
47          "rewardDetailsList": [
48            {
49              "productSellingModel": {
50                "name": "Monthly",
51                "id": "0jPxx0000000001EAA"
52              },
53              "discountType": "PercentageOff",
54              "discountValue": 10,
55              "termBasedRewards": {
56                "psmTenure": {
57                  "tenure": "SpecificTerm",
58                  "operator": "Equals",
59                  "value": 12
60                },
61                "rewardDuration": {
62                  "tenure": "SpecificTerm",
63                  "value": 3
64                }
65              }
66            }
67          ],
68          "childProducts": [],
69          "type": "PSMDiscount",
70          "isPrimaryReward": false
71        }
72      ],
73      "ruleName": "rule",
74      "templateName": "GetRewardsBasedOnSellingModel"
75    }
76  ]
77}

See Promotions Creation API reference to get additional details of the request and response properties.