Skip to main content
POST
/
v1
/
customers
/
{identifier}
/
points
Adjust points
curl --request POST \
  --url https://api.mageloyalty.com/v1/customers/{identifier}/points \
  --header 'Authorization: <api-key>'
Manually add or deduct points for a customer. Useful for CS teams handling complaints, migrations from another platform, or any bespoke earning scenario not covered by earning rules.

​
Request body

FieldTypeRequiredDescription
adjustmentintegerYesPoints to add (positive) or deduct (negative). Cannot be zero.
notestringNoInternal note stored on the audit record
update_lifetime_pointsbooleanNoWhether to also adjust lifetime points. Default: true
send_emailbooleanNoWhether to send a points-earned email to the customer (increases only). Default: true
{
  "adjustment": 500,
  "note": "Goodwill gesture after delayed order",
  "update_lifetime_points": true,
  "send_email": true
}

​
Behaviour

  • Points balance floors at 0 — deductions will never produce a negative balance
  • Customer tier is recalculated automatically after the adjustment
  • Creates an audit trail entry in the customer’s earning history

​
Side effects

All non-blocking:
  • Recalculates and updates VIP tier
  • Sends points-earned email on increases (if send_email: true)
  • Syncs customer to Klaviyo, Omnisend, and Postscript

​
Response

Returns 200 OK: 
{
  "data": {
    "type": "points_adjustment",
    "id": "6789012345",
    "attributes": {
      "shopify_customer_id": "6789012345",
      "adjustment": 500,
      "points_before": 200,
      "points_after": 700,
      "current_points": 700,
      "note": "Goodwill gesture after delayed order"
    }
  }
}

​
Errors

StatusScenario
400adjustment missing, zero, or not an integer
403Customer is excluded from the loyalty program
404Customer not found