Change Tier

Change the tier for a specified loyalty program member.

This action is available in API version 51.0 and later for users with Loyalty Management license.

URI: /services/data/vXX.X/actions/standard/changeTier

Formats: JSON, XML

HTTP Methods: POST

Authentication: Authorization: Bearer token

InputTypeDescription
ChangeReasonstringThe reason for change in member tier.
CustomTierExpiryDatedateAny date can be provided as input. This value overrides the Tier Expiration Date field on Loyalty Member Tier. Previously, the expiration date was calculated based on the membership duration defined in the Loyalty Tier Group. Now, customers can specify any date, including a past date.
LoyaltyProgramMemberIdIDRequired. ID of the loyalty program member.
ProgramNamestringRequired. The loyalty program name associated with the tier.
TargetTierNamestringRequired. The new tier to be associated with the loyalty program member
TierGroupNamestringRequired. The name of the tier group.
OutputTypeDescription
LoyaltyProgramMemberIdstringID of the loyalty program member.
ProgramNamestringThe name of the loyalty program.
TierExpirationDatestringExpiration date on the Loyalty Member Tier record after the change tier action completes.
TierGroupNamestringThe name of the tier group.
TierNamestringThe new tier associated with the loyalty program member.

Sample Request

Sample Response