Postscript is an SMS platform. These events only trigger automations for customers who are SMS subscribers, matched by their Shopify Customer ID. If a customer has not opted in to SMS, the event still fires but no message is sent.

Fired when a customer earns points through purchases, actions, or other earning rules.

Subscriber: Matched by Shopify Customer ID (fallback: email)

A note on property keys. Every event property key uses hyphens instead of spaces (for example Reward-Name), because Postscript SMS merge tags cannot reference keys that contain spaces. Reference any property in a template with its key, such as {{ Reward-Name }}.

Fired when points are recorded in a pending state. The points are awarded later, once the refund or approval window has passed.

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)

Points Pending mirrors Points Awarded and uses the same keys, referenced with merge tags such as {{ Points-Awarded }}.

Fired when a customer earns flat bonus points from a tiered bonus campaign. This is a separate award from the standard points earned on the order.

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)

Reference a property in an SMS template with its key, for example {{ Bonus-Points }}.

Fired when a customer redeems their points for a reward or discount.

Subscriber: Matched by Shopify Customer ID (fallback: email)

Fired when a customer moves up or down VIP tiers based on their lifetime points.

Subscriber: Matched by Shopify Customer ID (fallback: email)

Fired when an advocate sends a referral email invite to a friend.

This event is OFF by default. Merchants must enable it in Settings > Integrations > Postscript before it will fire.

Subscriber: The advocate, matched by Shopify Customer ID (fallback: email)

The email subject and personal message are intentionally omitted, because long free text is not useful as an SMS merge tag. Reference a property with its key, for example {{ Referral-URL }}.

Fired when a friend claims their referral discount code.

This event is OFF by default. Merchants must enable it in Settings > Integrations > Postscript before it will fire.

Subscriber: The friend, matched by Shopify Customer ID (fallback: email)

Reference a property with its key, for example {{ Discount-Code }}.

Fired when an advocate earns their reward after their friend completes a qualifying purchase.

This event is OFF by default. Merchants must enable it in Settings > Integrations > Postscript before it will fire.

Subscriber: The advocate, matched by Shopify Customer ID (fallback: email)

Reference a property with its key, for example {{ Discount-Code }}.

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)

Hey {{ Customer-Name }}, you have {{ Points-Expiring }} points expiring in {{ Days-Until-Expiry }} days! Shop now to use them before they're gone.

Fired by the daily gift reminders cron for each upcoming occasion a customer has saved.

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)

Reference a property with its key, for example {{ Recipient-Name }}.

Fired by the daily birthday cron when a customer earns their birthday points.

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)

Reference a property with its key, for example {{ Points-Earned }}.

Store-credit cashback awarded.

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)

Reference a property with its key, for example {{ Cashback-Amount-Formatted }}.

Cashback issued as a single-use discount code, including a reissue after a partial refund (a new code with a reduced amount).

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)

Reference a property with its key, for example {{ Discount-Code }}.

In addition to events, Mage syncs the following properties to each Postscript subscriber. These can be used in segments and SMS personalization.

Mage Amount To Next Vip Tier is measured in whatever your VIP tiers are based on: points, amount spent, or number of orders. If your tiers are points based, a value of 380 means the customer needs 380 more points. If your tiers are spend based, it means 380 more in your store currency. When your program uses more than one tier requirement, this amount reflects your primary requirement.

Both properties are only synced when VIP tiers are enabled on your loyalty program. Customers who have already reached your highest tier receive an empty value for both, so you can segment on that to find your top tier members.