Change Tier | Loyalty Management Developer Guide

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

Supported REST HTTP Methods

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

Inputs

Input	Details
ChangeReason	Type string Description The reason for change in member tier.
CustomTierExpiryDate	Type date Description Any 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.
LoyaltyProgramMemberId	Type ID Description Required. ID of the loyalty program member.
ProgramName	Type string Description Required. The loyalty program name associated with the tier.
TargetTierName	Type string Description Required. The new tier to be associated with the loyalty program member
TierGroupName	Type string Description Required. The name of the tier group.

Outputs

Output	Details
LoyaltyProgramMemberId	Type string Description ID of the loyalty program member.
ProgramName	Type string Description The name of the loyalty program.
TierExpirationDate	Type string Description Expiration date on the Loyalty Member Tier record after the change tier action completes.
TierGroupName	Type string Description The name of the tier group.
TierName	Type string Description The new tier associated with the loyalty program member.

Example

Sample Request

1{
2  "inputs": [
3    {
4      "TierGroupName": "QualifyingGroup",
5      "ProgramName": "baProgram",
6      "TargetTierName": "Gold",
7      "LoyaltyProgramMemberId": "0lcxx00006000001AAA",
8      "ChangeReason": "Reason to change the tier",
9      "CustomTierExpiryDate": "2026-12-31"
10    }
11  ]
12}

Sample Response

1{
2  "errors": null,
3  "isSuccess": true,
4  "outputValues": {
5    "LoyaltyProgramMemberId": "0lMxx0000A000001EAA",
6    "TierGroupName": "QualifyingGroup",
7    "ProgramName": "baProgram",
8    "TierName": "Gold",
9    "TierExpirationDate": "2026-12-31"
10  }
11}