Merge Memberships Action
Merges two active loyalty program member records that belong to the
same loyalty program. Out of the two memberships, one is source membership and the other is
the target membership. After the merge is complete, the status of the source membership is changed
to Merged and the status of the target membership remains active.
By default, all the transaction journals and points of the source member are transferred to
the target member after the merge. Optionally, you can:
- Transfer all the vouchers of source member to the target member.
- Assign the higher current tier between the source and target members to the target member.
For more information about how the mergeLoyaltyProgramMembership action merges loyalty program memberships, see Merge Memberships in Salesforce Help.
This action is available in API version 56.0 and later for users in orgs where Loyalty Management is enabled.
Supported REST HTTP Methods
- URI
- /services/data/vXX.X/actions/standard/mergeLoyaltyProgramMembership
- Formats
- JSON, XML
- HTTP Methods
- POST
- Authentication
- Authorization: Bearer token
Inputs
Input | Details |
---|---|
reasonForMergingMemberships |
|
shouldSetHigherCurrentTierForTargetMember |
|
shouldTransferVouchers |
|
sourceLoyaltyProgramMemberId |
|
targetLoyaltyProgramMemberId |
|
Outputs
Output | Details |
---|---|
errors |
|
isSuccess |
|
Examples
Sample Request
{
"inputs": [ {
"reasonForMergingMemberships": "Test Merge",
"shouldSetHigherCurrentTierForTargetMember": true,
"shouldTransferVouchers": true,
"sourceLoyaltyProgramMemberId":"0lMT100000001JnMAK",
"targetLoyaltyProgramMemberId":"0lMT100000001JnMAI"
} ]
}
Sample Response
[ {
"actionName" : "mergeLoyaltyProgramMembership",
"errors" : null,
"isSuccess" : true
} ]