Adjust loyalty points
Add or deduct points on a loyalty customer's balance with a reason and a note.
MCP tool yotpo_write → adjust_loyalty_points
write Confirm
reward_customer and remove_earned_points change both the balance and total earned points, so they can move the customer's tier. The other reasons change the balance only. The call returns the balance, total earned and tier after the change. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| email string required | string | Customer email address, exactly as in Yotpo. |
| direction enum required | enum | add or deduct. |
| points integer required | integer | Number of points, a positive whole number. |
| reason enum required | enum | Add: reward_customer or refund_points_deducted. Deduct: redeem_points_for_discount, remove_earned_points or manually_expire_points. |
| note string required | string | Explanation shown in the customer's Rewards History. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "yotpo_write",
"arguments": {
"operation": "adjust_loyalty_points",
"arguments": {
"email": "ana.lopez@example.com",
"direction": "add",
"points": 150,
"reason": "refund_points_deducted",
"note": "Points lost to a cancelled redemption, support ticket 4821"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"email": "ana.lopez@example.com",
"direction": "add",
"points": 150,
"reason": "refund_points_deducted",
"points_balance": 240,
"points_earned_total": 1020,
"tier": "Silver"
},
"isError": false
}