Promotion

Represents detail about a promotion associated with the loyalty program. It captures the information such as type of the promotion, issue of a voucher or credit points, promotion enrollment, and status of the promotion. This object is available in API version 51.0 and later.

Supported Calls

create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert()

Fields

Field	Details
CampaignId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The campaign associated with the promotion.
Category	Type picklist Properties Create, Filter, Group, Nillable, Sort, Update Description Broad classification of promotions. Possible values are: `Advertising` `Personal Selling` `Publicity` `Sales Promotion`
CumulativeUsageTarget	Type int Properties Create, Filter, Group, Nillable, Sort, Update Description The number of times a member must participate or the amount of money spent to qualify for a reward.
CurrentLiabilityAmount	Type currency Properties Create, Filter, Nillable, Sort, Update Description The liability amount incurred for the promotion until now. This field is available in API version 52.0 and later.
CurrentPointCount	Type int Properties Create, Filter, Group, Nillable, Sort, Update Description The liability amount incurred for the promotion until now. This field is available in API version 52.0 and later.
DefaultVoucherDefinitionId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The voucher associated with the promotion.
Description	Type textarea Properties Create, Filter, Nillable, Sort, Update Description Description of the promotion.
EndDate	Type date Properties Create, Filter, Group, Nillable, Sort, Update Description End date of the promotion.
EnrollmentEndDate	Type date Properties Create, Filter, Group, Nillable, Sort, Update Description The last date to enroll in the promotion.
EnrollmentStartDate	Type date Properties Create, Filter, Group, Nillable, Sort, Update Description The first date to enroll in the promotion.
FulfillmentAction	Type picklist Properties Create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description Select how a loyalty member is rewarded for fulfilling promotion requirements. Possible values are: `CreditPoints`—Credit Points `IssueVoucher`—Issue Voucher
IsActive	Type boolean Properties Create, Defaulted on create, Filter, Group, Sort, Update Description Indicates whether the promotion is active. This field is available in API version 52.0 and later.
IsEnrollmentRequired	Type boolean Properties Create, Defaulted on create, Filter, Group, Sort, Update Description Indicates whether enrollment is required to participate in the promotion.
IsPointsWithFactor	Type boolean Properties Create, Defaulted on create, Filter, Group, Sort, Update Description Indicates whether the promotion is applied by multiplying points with a factor or by using the fixed value in the TotalRewardPoints field. This field is available in API version 52.0 and later. The default value is `False`.
IssuedVoucherCount	Type int Properties Create, Filter, Group, Nillable, Sort, Update Description The vouchers that have been issued for the promotion until now. This field is available in API version 52.0 and later.
LastReferencedDate	Type dateTime Properties Filter, Nillable, Sort Description The most recent date on which a user referenced this record.
LastViewedDate	Type dateTime Properties Filter, Nillable, Sort Description The most recent date on which a user viewed this record.
Level	Type picklist Properties Create, Filter, Group, Nillable, Sort, Update Description Level at which a promotion is applicable. Possible values are: `Product` `Product Category`
LoyaltyProgramCurrencyId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The loyalty program currency associated with the promotion.
LoyaltyProgramId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The loyalty program associated with the promotion.
LoyaltyPromotionType	Type picklist Properties Create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description The type of promotion. Possible values are: `Cumulative` `Standard`
MaximumLiabilityAmount	Type currency Properties Create, Filter, Nillable, Sort, Update Description The maximum liability amount that can be incurred for the promotion.
MaximumRewardValue	Type int Properties Create, Filter, Group, Nillable, Sort, Update Description The total value that can be accumulated for the promotion.
MaximumVoucherCount	Type int Properties Create, Filter, Group, Nillable, Sort, Update Description The maximum number of vouchers that can be issued for the promotion. This field is available in API version 52.0 and later.
Methods	Type picklist Properties Create, Filter, Group, Nillable, Sort, Update Description Method of executing a promotion. Possible values are: `Contests` `Coupons` `Credit Facility` `Discounts` `Display and Exhibition` `Exchange Offer` `Free Services` `Gifts` `Sampling and Demonstration` `Trade Show`
Name	Type string Properties Create, Filter, Group, idLookup, Sort, Update Description Unique identifier for the promotion.
Objective	Type textarea Properties Create, Filter, Nillable, Sort, Update Description Business objective of the promotion. For example, launching a new product, keeping customers satisfied, or clearing stock.
OwnerId	Type reference Properties Create, Defaulted on create, Filter, Group, Sort, Update Description The ID of the user who owns this record.
PointFactor	Type double Properties Create, Filter, Nillable, Sort, Update Description The factor with which points are multiplied or divided when `IsPointsWithFactor` is set to true. This field is available in API version 52.0 and later.
StartDate	Type date Properties Create, Filter, Group, Sort, Update Description Required. The start date of the promotion.
Status	Type picklist Properties Create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description The status of the promotion. Possible values are: `Cancelled` `Complete` `Draft` `InProgress`
TotalRewardPoints	Type int Properties Create, Filter, Group, Nillable, Sort, Update Description The points awarded on availing the promotion.
TransactionJournalType	Type picklist Properties Create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description The journal type that has been applied for the promotion. This field is available in API version 52.0 and later. Possible values are: `Accrual` `Redemption`

Loyalty Management Developer Guide

Promotion

Supported Calls

Fields