Note: This release is in preview. Features described here don’t become generally available until the latest general availability date that Salesforce announces for this release. Before then, and where features are noted as beta, pilot, or developer preview, we can’t guarantee general availability within any particular time frame or at all. Make your purchase decisions only on the basis of generally available products and features.

Clone Promotion (POST)

Clone an existing promotion along with its associated records

Resource

1/promotions/clone

Available version

61.0

HTTP methods

POST

JSON example

1{
2  "sourcePromotionId": "0c8xx00000000WHAAY",
3  "name": "ups clone 4",
4  "startDateTime": "2024-01-08T00:00:00.000Z",
5  "endDateTime": "2024-01-09T00:00:00.000Z",
6  "promotionCode": "sdfgy543wsd",
7  "doesReuseEngagementAttributes":"true",
8  "additionalFieldValues": {
9    "additionalFieldValuesMap": {
10      "Description": "test ups clone"
11    }
12  },
13  "relatedRecords": {
14    "relatedRecordsList": [
15      {
16        "relatedObjectApiName": "PromotionChannel",
17        "relatedObjectPromotionFieldName": "PromotionId"
18      },
19      {
20       "relatedObjectApiName": "PromotionLoyaltyPtnrProdt",
21        "relatedObjectPromotionFieldName": "PromotionId"
22      },
23        {
24       "relatedObjectApiName": "PromotionMarketSegment",
25        "relatedObjectPromotionFieldName": "PromotionId"
26      },
27      {
28        "relatedObjectApiName": "PromotionProduct",
29        "relatedObjectPromotionFieldName": "PromotionId"
30      },
31      {
32        "relatedObjectApiName": "PromotionProductCategory",
33        "relatedObjectPromotionFieldName": "PromotionId"
34      },
35      {
36        "relatedObjectApiName": "PromotionLimit",
37        "relatedObjectPromotionFieldName": "PromotionId"
38      }
39    ]
40  }
41}

Properties

Name	Type	Description	Required or Optional	Available Version
`additionalFieldValues`	Map<String, String>	Details of the promotion's additional fields.	Optional	61.0
`doesReuseEngagementAttributes`	Boolean	Indicates whether the new promotion uses the engagement attributes created for the source promotion to track customers' promotion usage (`true`) or not (`false`). Engagement reuse can result in shared limits.	Optional	61.0
`endDateTime`	String	End date and time of the new promotion.	Required	61.0
`name`	String	Name of the new promotion.	Required	61.0
`promotionCode`	String	Code of the new promotion.	Optional	61.0
`relatedRecords`	Related Promotion Records Input []	Related record for the source promotion that have to be created for the new promotion.	Optional	61.0
`sourcePromotionId`	String	ID of the promotion that's cloned.	Required	61.0
`startDateTime`	String	Start date and time of the new promotion.	Required	61.0

Response body for POST: Clone Promotion

Loyalty Management Developer Guide

Clone Promotion (POST)