Points Changed

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.



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 Attributes



The email address of the customer whose point balance changed


The customer’s point balance before the change


The customer’s point balance after the change


How many points were added or removed from the customer’s point balance


Delineates whether points were added or removed from the customer’s point balance


Describes 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": "http://rwrd.io/3120htx",
    "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"



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'.