Note: This release is in preview. Features described here don’t become generally available until the latest general availability date that Salesforce announces for this release. Before then, and where features are noted as beta, pilot, or developer preview, we can’t guarantee general availability within any particular time frame or at all. Make your purchase decisions only on the basis of generally available products and features.

Update Member Tier

Upgrade or downgrade tier for a loyalty member.

Example URL

1https://yourInstance.salesforce.com/services/data/v68.0/connect/loyalty/programs/DemoProgram/program-processes/update Tier

The request and response parameters vary depending on the input and output parameters configured for the TierProcessing process type in a Salesforce org.

Sample JSON Requests

Some of the API request fields contain field names that are interchangeable. For information on the list of interchangeable field names, see Loyalty Management Connect API Interchangeable Request Fields.

Note

Here's an example with a member ID:

1{
2   "processParameters":[
3      {
4         "MemberId":"0lMRM0000004GBs2AM",
5         "NewTier":"Gold",
6         "ReasonForChange":"update tier"
7      }
8   ]
9}

Here's an example with a membership number:

1{
2   "processParameters":[
3      {
4         "MembershipNumber":"M2_Chloe_Sun",
5         "NewTier":"Gold",
6         "ReasonForChange":"update tier"
7      }
8   ]
9}

Sample JSON Response

1{
2   "message":null,
3   "outputParameters":{
4      "results":[
5         {
6            "CurrentTier":"Gold",
7            "TierExpirationDate":"2023-10-31",
8            "PreviousTier":"Silver",
9            "EffectiveDate":"2023-09-07"
10         }
11      ]
12   },
13   "simulationDetails":{
14      
15   },
16   "status":true
17}