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.
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.
IsEnrollmentRequired	Type boolean Properties Create, Defaulted on create, Filter, Group, Sort, Update Description Indicates whether enrollment is required to participate in the promotion.
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`
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.
StartDate	Type date Properties Create, Filter, Group, Sort, Update Description 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`—In Progress
TotalRewardPoints	Type int Properties Create, Filter, Group, Nillable, Sort, Update Description The points awarded on availing the promotion.

Loyalty Management Developer Guide

Promotion

Supported Calls

Fields