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!
Key notes
- This integration is available on all paid plans
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 Install App.
- If you have an existing integration but haven't updated to OAuth yet, the button will say Refresh Your Klaviyo Access Token and appear like below with the Site ID and Private API Key Fields present.
- If you have an existing integration but haven't updated to OAuth yet, the button will say Refresh Your Klaviyo Access Token and appear like below with the Site ID and Private API Key Fields present.
- Once redirected to Klaviyo, give Stamped permission to access accounts, events, and profiles. This will complete the integration.
- Your Klaviyo Account is connected successfully with OAuth if you see the following, without the Site ID and Private API Key fields present.
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