With our Klaviyo integration, you'll be able to create automated emails to target specific customer groups based on their recent Loyalty & Rewards events. For example, you can send a “Happy Birthday” email to a customer on their special day, or include the customer's reward points balance, VIP tier, or referral link as a section in your email template to be used in campaigns!
Follow this guide to learn more.
This integration is available on the Business, Professional, and Enterprise plan
In This Guide
- How to Connect
- Customer Events & Properties
- Creating a Segment to Filter for Tracking Events
- Common Use-case and Example
- Including Customer Properties Into The Email Template
- Common Use-case and Example of Customer Properties
How to Connect
- In the Stamped Dashboard, go to the following link: https://go.stamped.io/v3/#/settings/apps/klaviyo
- Click on the green button that says Connect Your Klaviyo Account. If you have a existing integration but haven't updated to OAuth yet, the button will say Reconnect Your Klaviyo Account instead.
- Once redirected to Klaviyo, give Stamped permission to access accounts, events, and profiles. This will complete the integration.
When any loyalty actions occur after the integration has been enabled, a custom event will be created in the customer's Klaviyo profile.
Customer Events & Properties
Loyalty Customer Properties
Property Name | Description | Trigger |
stamped_account_confirmed | Boolean value that determines whether or not a customer has an account with the merchant. | Automatically True |
stamped_rewards_created_date | The date the customer’s account was created with the merchant. | Initial merchant creation |
stamped_rewards_birthday | The date of the customer’s birthday. | - Initial merchant sync - Birthday updated |
stamped_rewards_points | Current loyalty points balance of the customer. | Any Points_Activity record creation or update |
stamped_rewards_vip_tier | Current VIP tier of the customer. | Any activity with tiers/% event |
stamped_rewards_referral_link | The url that enables a customer to refer new business to the merchant. | Customer created in merchant |
stamped_last_activity_date | The date of the last activity taken by a customer. This can help determine whether they are still an active member of the loyalty program and engaged with the Merchant’s products or might be churning. | Any Points_Activity record except manual/adjustment, points/expiry, notifications/expiry, coupons/expiry, coupons/void, points/void |
stamped_points_expiry_date | The date that the customer’s points will expire if they take no further action. This date will move into the future synchronously alongside “stamped_last_activity_date”. | Follows stamped_last_activity_date above - any update there should flow through to here - Any change to expiry settings for the store needs to fire this update for ALL CUSTOMERS |
stamped_current_tier_entry_date | The date a customer entered their current VIP tier. | Any tiers/upgrade or tiers/downgrade event |
stamped_next_tier_name | The name of the next highest VIP tier above the customer’s current status. | Any tiers/upgrade or tiers/downgrade event- Any change to tier settings or tier rule |
stamped__tier_downgrade_date | The date a customer will downgrade from their current VIP tier if they take no further action. | - Any tiers/upgrade or tiers/downgrade event - Any order - Any Points_Activity record creation or update- Any change to VIP Tier settings or a rule needs to fire this for the full customer base |
stamped_discounts_ready_to_use | List of coupon codes that the customer has already redeemed for points but has not used with an order. | Any Points_Reward creation or update |
stamped_rewards_referral_code | The customer’s code to refer new business to the Merchant. | Customer creation |
stamped_rewards_last_redeemed_points_date | The date a customer last exchanged their points for rewards. | Any Points_Activity with pointsCredit > 0 and event ilike '%redeem%' |
stamped_lifetime_points_spent | The total number of points a customer has spent across all interactions with this merchant (ex manual adjustments) | Any Points_Activity update |
stamped_lifetime_points_earned | The total number of points a customer has earned across all interactions with this merchant (ex manual adjustments) | Any Points_Activity update |
Loyalty Events
Event | Description | Properties | Trigger |
EarnAccountNew | New account creation reward | [ "activity_points", "activity_title", "stamped_rewards_points"] |
Any customer/create activity |
BirthdaySet | This event fires when the user sets a birthday | [”birthday”] | Birthday set in merchant space |
EarnAccountBirthday | Account birthday reward | [ "activity_points", "activity_title", "stamped_rewards_points"] |
Any milestones/birthday activity |
EarnAccountAnniversary | Account anniversary reward | [ "activity_points", "activity_title", "stamped_rewards_points"] |
Any milestones/anniversary activity |
PointsExpired | Customer points expire | [ "last_activity_at", "points_expired"] | Any activity with event = points/expiry |
earnOrderNew | Order earning activity based on making a purchase | [ "activity_points", "activity_title", "stamped_rewards_points"] |
Any activity with orderDebit source action and interactionType = makePurchase OR interactionType = amountSpent |
spendRewardRedeemed | Any point redemption | [ "activity_points", "activity_title", "coupon_code", "stamped_rewards_points"] |
Any activity with pointsCredit > 0 and event ilike %redeem% |
earnOrderCount | Order earning activity based on number of lifetime orders | [ "activity_points", "activity_title", "stamped_rewards_points"] |
Any activity with orderDebit source action and interactionType = totalNumberOfOrdersGoal |
PurchasedWithReward | This event fires when a customer makes a purchase with a coupon code applied | [”activity_title”,”coupon_code”, ”stamped_rewards_points”] |
Activity with coupon/consumed |
CouponExpired | This event fires when a customer's coupon expires | [”coupon_created_at”, ”stamped_rewards_points”, ”coupon_code”] |
Activity with coupons/expiry or coupons/void |
earnOrderAmount | Order earning activity based on amountSpent | [ "activity_points", "activity_title", "stamped_rewards_points"] |
Any activity with orderDebit source action and interactionType = orderValueTotalGoal |
refundOrder | This event fires when a previously rewarded order is refunded. | [ "activity_points", "activity_title", "stamped_rewards_points"] |
Any activity with sourceAction = orderCredit |
VIPTierUpdated | This events fires on any tier update | [ "stamped_rewards_change_direction", "stamped_rewards_points", "stamped_rewards_previous_vip_tier", "stamped_rewards_vip_tier"] | Any tiers/upgrade or tiers/downgrade activity |
earnReviewNps | Customers earns points for leaving NPS | [ "activity_points", "activity_title", "stamped_rewards_points"] |
Any activity with event = content/nps_survey |
earnQuestionAnswer | Customer earns points for submitting question answer | [ "activity_points", "activity_title", "stamped_rewards_points"] |
Any activity with event = content/submit_answer |
earnReview | Customer earns points for leaving review | [ "activity_points", "activity_title", "stamped_rewards_points"] |
Any activity with event = content/write_review |
earnPhotoReview | Customer earns points for leaving photo review |
[ "activity_points", "activity_title", "stamped_rewards_points"] |
Any activity with event = content/upload_photo |
earnVideoReview | Customers earns points for video review | [ "activity_points", "activity_title", "stamped_rewards_points"] |
Any activity with event = content/upload_video OR content/upoad_video |
sharedReferral | This event fires when Customer X sends a referral to friend Y. There is no coupon code yet generated.This event should fire connected to Customer X. | [ "activity_reward_type", "activity_reward_value", "activity_title"] | Customer sends referral email to friend |
receivedReferral | This event fires when friend Y receives a referral from Customer X.This event fires connected to Friend Y.Properties referral_email, link and name refer to Customer X. | [ "activity_reward_type", "activity_reward_value", "activity_title", "referral_email", "referral_link", "referral_name"] |
Inverse of ReferralShared, this is for the friend who’s the recipient of the referral |
accpetedReferral | This event fires when friend Y accepts the referral and gets their coupon code.This event should fire connected to friend Y. | [ "activity_reward_type", "activity_reward_value", "activity_title", "coupon_code"] | When friend claims the referral and discount code is generated |
referredCustomer | This event fires for a customer X when their friend Y completes a purchase with the referral coupon code.This fires connected to Customer X. | [”activity_title”,”activity_reward_value”, ”activity_reward_type”, ”referral_email”,”referral_link”, ”referral_name”,”coupon_code”] |
Friend successfully completes referral and customer/affiliate activity fires |
earnSocialFollowFacebook | Customer earns points for a Facebook follow | [ "activity_points", "activity_title", "stamped_rewards_points"] |
Any activity with event = socials/facebook_like |
earnSocialFollowInstagram | Customer earns points for an Instagram follow | [ "activity_points", "activity_title", "stamped_rewards_points"] |
Any activity with event = socials/instagram_follow |
EarnSocialFollowTwitter | This event fires when a customer follows you on Twitter | [ "activity_points", "activity_title", "stamped_rewards_points"] | Activity with event = socials/twitter_follow |
EarnSocialFollowPinterest | This event fires when a customer follows you on Pinterest | [ "activity_points", "activity_title", "stamped_rewards_points"] | Activity with event = socials/pinterest_follow |
EarnSocialFollowTiktok | This event fires when a customer follows you on Tiktok | [ "activity_points", "activity_title", "stamped_rewards_points"] | Activity with event = socials/tiktok_follow |
EarnSocialYoutube | This event fires when a customer follows you on Youtube | [ "activity_points", "activity_title", "stamped_rewards_points"] | Activity with event = socials/youtube_subscribe |
earnSocialShareTwitter | Customer earns points for a Twitter share | [ "activity_points", "activity_title", "stamped_rewards_points"] |
Any activity with event = socials/twitter_share |
earnSocialShareFacebook | Customer earns points for Facebook share | [ "activity_points", "activity_title", "stamped_rewards_points"] |
Any activity with event = socials/facebook_share |
earnNewsletter | Subscription to newsletter reward |
[ "activity_points", "activity_title", "stamped_rewards_points"] |
Any subscriptions/newsletter activity |
Creating a Segment to Filter for Tracking Events
You can create a segment in Klaviyo to group the customers according to the events (customers who submitted a positive review in one segment, negative review in another etc.)
- Head over to Lists & Segments under the left menu:
- Create a new segment:
- Select "What someone has done (or not done)" under the definition drop-down list, which filters for tracking events:
- Search for Stamped's tracking events, which will be under the API category:
- Fill up the rest of the details for the segment as required.
Here's a detailed guide from Klaviyo on creating a segment: https://help.klaviyo.com/hc/en-us/articles/115005237908-Create-a-Segment
Common Use-case and Example
- Create a flow to send an email for new customers who have signed up for the Loyalty & Rewards program:
- Create a flow to send an email when customers have redeemed points for rewards:
Including Customer Properties Into The Email Template
These properties will be pushed to Klaviyo customer's profile:
- stamped_rewards_birthday
- stamped_rewards_points
- stamped_rewards_referral_link
- stamped_rewards_vip_tier
- Click on a text-block of your email template where you would like to include the properties:
- Click on the "Insert Property" dropdown box
- Enter "stamped_rewards" in the search field for easy access to the available customers' properties for our Loyalty & Rewards program
- Select the customer property that you would like to include in your email
- Click on the Save button.
Common Use-case and Example of Customer Properties
- Reminder email to Loyalty & Rewards customers to shop and spend their points if they have not made a purchase in 6 months, with the customer's current points pulled into the email:
1. Create a segment for Loyalty & Rewards customers who have not shopped in your store for the last 6 months:
2. Create a flow with the segment created above, followed by an email
3. Use the customer properties ( stamped_rewards_points) in the email to dynamically update and display the point that your customer has