Events
Points Awarded
Fired when a customer earns points through purchases, actions, or other earning rules.
Subscriber: Matched by Shopify Customer ID (fallback: email)
Property | Type | Description |
| number | Number of points earned |
| string | Name of the earning rule (or "Manual") |
| string | Status of the earning (e.g. |
| string (optional) | Shopify order number, if points were earned from a purchase |
Reward Redeemed
Fired when a customer redeems their points for a reward or discount.
Subscriber: Matched by Shopify Customer ID (fallback: email)
Property | Type | Description |
| string | Name of the reward redeemed |
| number | Number of points spent (0 if null) |
| string | Type of discount (e.g. |
VIP Tier Changed
Fired when a customer moves up or down VIP tiers based on their lifetime points.
Subscriber: Matched by Shopify Customer ID (fallback: email)
Property | Type | Description |
| string | Name of the tier the customer moved to |
| string (optional) | Name of the previous tier, if applicable |
Points Expiry Soon
Fired when a customer has loyalty points expiring within the next 7 days. This event is triggered once per customer per 7-day window — multiple earning rules expiring on different days are aggregated into a single event to prevent duplicate notifications.
This event is OFF by default. Merchants must enable it in Settings > Integrations > Postscript before it will fire.
Subscriber: Matched by Shopify Customer ID (fallback: email)
Property | Type | Description |
| number | Total points expiring within the next 7 days (aggregated across all earning rules) |
| number | Customer's current point balance at the time the event fires |
| number | Days until the earliest expiring points (e.g. |
| string | Customer's first name (or "there" if not set) |
Suggested automation setup
In Postscript, go to Automations > Create Automation
Set the trigger to the Points_Expiry_Soon event
Add a Send SMS action with your expiry reminder message
Use the event properties above to personalize the message
Example SMS
Hey {{ Customer Name }}, you have {{ Points Expiring }} points expiring in {{ Days Until Expiry }} days! Shop now to use them before they're gone.
Subscriber Properties
In addition to events, Mage syncs the following properties to each Postscript subscriber. These can be used in segments and SMS personalization.
Property | Example Value | Description |
|
| Customer's current spendable points |
|
| Total points ever earned |
|
| Total points spent on rewards |
|
| Current VIP tier (e.g. Bronze, Silver, Gold) |
|
| Customer's date of birth, if provided |
|
| When the customer joined the loyalty program |