Loyalty Management Developer Guide

Loyalty Management Standard Objects
Loyalty Management Fields on Standard Objects
Loyalty Management Associated Objects
Apex Reference
Loyalty Management Business APIs
Loyalty Management Standard Invocable Actions
Adjust Points
Assign Member Tier Benefits
Accrual Cancellation
Credit Points
Change Tier
Change All Tiers or None
Debit Points
Generate Referral Code
Get Member's Active Segments
Get Points Balance
Get Promotions Based on Member's Market Segement
Get Promotions Based on Transaction Journal
Get Tier
Issue Voucher
Merge Memberships Action
Process Member Benefit
Redemption Cancellation
Run Program Process for Transaction Journal
Transfer Member Points to Groups
Unmerge Memberships Action
Update Member Progress for Cumulative Promotion
Loyalty Management Custom Invocable Actions
Loyalty Management Metadata API Types
Loyalty Management Tooling API Objects
Loyalty Management Mobile SDK
Gamification Mobile SDK
Data Processing Engine, Batch Management, and Monitor Workflow Services
Decision Table
PDF

Newer Version Available

This content describes an older version of this product. View Latest

Update Member Progress for Cumulative Promotion

Update the progress made by a loyalty program member towards attaining a Cumulative type promotion. The action creates a Loyalty Program Member Promotion record if the promotion isn't associated with the member.

For more information about this action, see Update the Member's Progress Towards Attaining a Cumulative Promotion in Salesforce Help.

This action is available in API version 53.0 and later for users in orgs where either B2C - Loyalty, B2C - Loyalty Plus, Loyalty Management - Growth, or Loyalty Management - Advanced license is enabled.

Supported REST HTTP Methods

URI
/services/data/vXX.X/actions/standard/updateProgressForCumulativePromotionUsage
Formats
JSON, XML
HTTP Methods
POST
Authentication
Authorization: Bearer token

Inputs

Input Details
loyaltyProgramMemberId
Type
ID
Description
Required. ID of the loyalty program member who progress towards attaining a cumulative promotion must be updated.
promotionId
Type
ID
Description
Required. ID of the Cumulative type promotion for which member's progress must be updated.
usageIncrementForCumulativePromotion
Type
integer
Description
Required. The value or quantity that must be added to member's usage towards attaining the promotion.

For example, if the target of a promotion is 10 units and the member has previously purchased 1 unit. Now the member has purchased 4 units. In this scenario, the input must be 4 and not 5 (1+4).

Outputs

Output Details
cumulativeUsageTarget
Type
integer
Description
The target value or quantity which members must achieve to attain the promotion.
updatedCumulativeUsageCompleted
Type
integer
Description
The updated value or quantity by which the member has progressed towards attaining the promotion.

For example, if the target of a promotion is 10 units and the member has previously purchased 1 unit. Now the member has purchased 4 units. In this scenario, the output is 5.

Example

Sample Request

Sample Response