Promotion

Create promotional activities that are either part of a campaign or isolated targeted promotions to run at retail stores. This object is available in API version 47.0 and later.

Supported Calls

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

Fields

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.

IsActive

Type: boolean
Properties: Create, Defaulted on create, Filter, Group, Sort, Update
Description: Indicates whether the promotion is active.

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:
- Product
- Product Category

Methods

Type: picklist
Properties: Create, Filter, Group, Nillable, Sort, Update
Description: Method of executing a promotion.
Possible values:
- 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: ID of the promotion record owner.

StartDate

Type: date
Properties: Create, Filter, Group, Sort, Update
Description: Start date of the promotion.

Associated Objects

This object has the following associated objects. Unless noted, they’re available in the same API version as this object.

PromotionChangeEvent (API Version 62.0): Change events are available for the object.
PromotionFeed: Feed are available for the object.
PromotionHistory: History is available for the object.
PromotionShare: Sharing is available for the object.