This event is triggered every time a customer’s point balance changes. The event will provide a customer’s previous point balance, current point balance, and how many points it changed by.

This event is useful for keeping an external system that stores a customer’s point balance in sync.


Please note:

The reason for the change in balance is included in the event and can be one of the following:

  • Campaign Earned - based on campaign title
  • Points Expired
  • Manual adjustment of points - based on description
  • Refund made
  • Import
  • Redemption Made
Important AttributesDescription
emailThe email address of the customer whose point balance changed.
previous_balanceThe customer’s point balance before the change.
current_balanceThe customer’s point balance after the change.
differenceHow many points were added or removed from the customer’s point balance.
added_or_removedDelineates whether points were added or removed from the customer’s point balance.
points_changed_reasonDescribes why there was a change in point balance.
  "topic": "swell/points/changed",
  "name": "Swell Points Changed",
  "email": "[email protected]",
  "customer": {
    "total_spend_cents": 3180,
    "total_purchases": 4,
    "perks_redeemed": 58,
    "last_purchase_at": "2019-11-28T12:50:52.000Z",
    "email": "[email protected]",
    "referred_by": "[email protected]",
    "points_earned": 2460,
    "points_balance": 460,
    "points_expire_at": null,
    "first_name": "a",
    "last_name": "a",
    "is_member": true,
    "accepts_marketing": false,
    "last_seen_at": "2019-12-09T16:41:26.214Z",
    "thirty_party_id": "2691804725305",
    "referral_link": "",
    "referral_discount_code": null,
    "has_store_account": true,
    "credit_balance": "₪0",
    "is_affiliate": false,
    "vip_tier_name": "Power User",
    "vip_tier_ends_at": "2019-12-31",
    "referral_code": {
      "code": "3120htx",
      "shares": 1,
      "facebook_shares": 1,
      "twitter_shares": 0,
      "email_shares": 0,
      "emails_sent": 0,
      "emails_viewed": 0,
      "links_clicked_from_email": 0,
      "links_clicked_from_twitter": 0,
      "links_clicked_from_facebook": 0,
      "orders": 0,
      "amount_cents": 0,
      "average_amount_cents": 0,
      "expires_at": null,
      "expired": false,
      "completed_referral_customers": [],
      "email": "[email protected]",
      "unique_clicks": 0,
      "total_clicks": 0
  "previous_balance": 960,
  "current_balance": 460,
  "difference": -500,
  "added_or_removed": "removed",
  "points_changed_reason": "Get ₪5.00 off your next purchase for 500 points",
  "timestamp": "2021-08-01T16:53:56.415+03:00"


Please note:

When a customer has their points balance changed due to redemption, the points_changed_reason will populate with the redemption option description value.
If the description is empty, the points_changed_reason will show 'unknown