Design Promotions Programmatically

Example The marketing team at Cloud Kicks is planning their summer marketing campaign for the 'Cloud Kicks Loyalty' loyalty program. To boost sales and reward their loyal customers, they want to create a promotion called Summer Sale. This promotion will run during the month of June and will offer a 10% discount on purchases over $50. The promotion is specifically for the Summer Sneakers product category on their app and is targeted towards their Loyal Customers segment. To ensure the promotion is effective, they want to limit its usage to 1000 times overall and 5 times per customer.

Here's what the Promotion Creation API's request looks like when the API is executed:

{
  "promotionDetails": {
    "name": "Summer Sale",
    "displayName": "Summer Sale Promotion",
    "priorityNumber": 1,
    "description": "Summer Sale promotion offering a 10% discount on purchases over $50",
    "promotionCode": "SUMMER2025",
    "startDateTime": "2025-06-01T00:00:00.000Z",
    "endDateTime": "2025-06-30T23:45:00.000Z",
    "loyaltyProgram": {
      "name": "CloudKicksLoyalty"
    },
    "promotionEligibility": {
      "productCatalog": {
        "id": "0ZSxx000000001dGAA"
      },
      "eligibleProductCategories": [
        {
          "id": "Summer Sneakers"
        }
       ],
      "eligibleChannels": [
        {
          "channelType": "Online",
          "channel": {
            "name": "App"
          }
        }
      ],
      "eligibleSegments": [
        {
          "name": "Loyal Customers"
        }
      ],
      "areAllLoyaltyMembersEligible": false     
    },
    "promotionLimits": {
      "usePerCustomerLimit": 5,
      "totalUseLimit": 1000
    }
  },
  "rules": [
    {
      "templateName": "BuyXToGetRewards",
      "ruleName": "SummerSaleRule",
      "priority": 1,
      "eventConfiguration": [
        {
          "allOf": [
            {
              "anyOf": {
                "purchaseType": "ProductCategory",
                "applicablePurchaseList": [
                  {
                    "name": "Summer Sneakers"
                  }
                ],
                "purchaseCriteria": {
                  "type": "Amount",
                  "value": 50
                }
              }
            }
          ]
        }
      ],
      "rewardConfiguration": [
        {
          "type": "ProvideDiscount",
          "rewardDetails": {
            "discountValue": "10",
            "discountType": "PercentageOff"
          },
          "targetAudience": {
            "audienceType": "AllLoyaltyMembers"
          }
        }
      ]
    }
  ]
}