Documented when points expire on loyalty webhook payloads: ISO 8601 date-time, or null if they never expire. Clarified Points expiration policy for:

Last Activity — expiration from the customer’s last activity
Date Earned — next upcoming batch expiration only (not every batch; multiple batches can have different dates)
Never expire — null

Changes

Topics (webhook events)

Updated JSON samples (including multiple customer-like objects where applicable) and added per-event customer.points_expire_at notes for:

Customer Birthday Captured
Customer Anniversary Captured
Loyalty Opt In / Loyalty Opt Out
Points Earned
Redemption Cancellation Request
Redemption Reminder
Referral Link Share (1.0 & 2.0)
Referral Share Reminder
Referral Completed (1.0 & 2.0)

Fixed invalid JSON in the Points Earned sample.

About Webhooks

Short pointer to Topics / Points Earned for the full customer.points_expire_at write-up.

Changelog

`customer.points_expire_at` on loyalty webhook events

Changelog

Welcome to the Yotpo API Changelog!