Fixed
Loyalty webhook payloads and Loyalty endpoints corrected
October 25th, 2026
The Loyalty & Referrals webhook events now show payloads that match what Yotpo sends:
- The referring customer is in
referred_by_customer(notreferred_by). - Events include
website_url,store_nameandpublished_at. - VIP Tier Status Changed sends
vip_statsin snake_case, for examplepoints_earnedandamount_spent_cents. - Customer objects include
is_opt_in,loyalty_opt_in_date,referral_link,referral_discount_code, credit balance and VIP tier fields. Points events includerelated_order_ids.
New: Account Created (swell/account/created). Triggered when a customer receives the reward for the New Member Reward earning rule.
Loyalty endpoint fixes:
- Adjust Loyalty Customer Points: only
customer_emailandpoint_adjustment_amountare required. You can identify the customer withcustomer_idinstead of the email.visible_to_customeris a boolean. - Record Loyalty Customer Action:
reward_pointsis an integer. - Retrieve Loyalty Customer Details by Email: send exactly one identifier (
customer_email,customer_id,pos_account_idorphone_number). The response fields are now described, including the points history and referral code.
Endpoints affected: all Loyalty & Referrals webhook events, Adjust Loyalty Customer Points, Record Loyalty Customer Action, Retrieve Loyalty Customer Details by Email.
