How to Build Klaviyo Loyalty Flows with Oshi Bitcoin Rewards
Build powerful Klaviyo email flows with Oshi Bitcoin Rewards. From purchase reward emails to referral bonuses and VIP tier updates, learn how to trigger, personalize, and automate loyalty communications that keep customers engaged.

Before You Start
This guide is for merchants who have already connected Oshi to Klaviyo. If you haven’t done that yet, follow our integration guide first.
Once connected, Oshi automatically pushes reward activity—purchases, redemptions, referrals, VIP tier changes, and more—directly into Klaviyo. This guide will show you how to turn that data into powerful customer flows.
By the end, you’ll know how to:
- Build core emails (purchase rewards, referral bonuses, social rewards)
- Add engagement emails (reminders, social engagement, referral links)
- Leverage customer properties for personalized content blocks (VIP status, referral stats, tier progress)
- Reference all available Liquid fields for rewards emails
Core emails
These are the essential customer communication emails for your Bitcoin rewards and loyalty program. Without them, customers won’t see the rewards they’ve earned, redeem bonuses, refer friends, engage on social for rewards, or take advantage of affiliate incentives. These emails keep customers aware of their rewards activity and motivated to keep earning and redeeming.
Purchase Reward Emails
These event-triggered emails are sent when a customer earns Bitcoin rewards on a purchase. Use a trigger split so the message and CTA fit their enrollment status.
Example Email Copy
Use these as starting points for your purchase reward emails. Customize the copy, branding, and design to match your voice and style. The liquid template fields will automatically populate with your customer's specific reward data.
First-Time Users (Not Yet Enrolled)
Send this to customers who earned their first Bitcoin rewards but haven't joined the program yet. The goal is to get them enrolled and claiming their rewards.
- Flow filter:
oshi_enrolled equals false
Email Content
You've earned {{ event.reward_sats_back|default:'' }} sats - Claim your Bitcoin rewards
Claim your {{ event.reward_btc_back|default:'' }} BTC before it expires.
Congratulations! You've earned {{ event.reward_sats_back|default:'' }} sats ({{ event.reward_btc_back|default:'' }} BTC) from your recent purchase. Claim your first Bitcoin reward and join our rewards program. Unclaimed rewards expire in 30 days.
{{ event.reward_portal_url|default:'' }}
Existing Members (Already Enrolled)
Send this to customers who are already program members. The goal is to show their updated balance and encourage continued engagement.
- Flow filter:
oshi_enrolled equals true
Email Content
{{ event.reward_sats_back|default:'' }} sats added to your balance
Your balance is updated. See what you can do next.
Nice! You just earned {{ event.reward_sats_back|default:'' }} sats ({{ event.reward_btc_back|default:'' }} BTC) from your purchase. Current balance: {{ person.oshi_rewards_current_balance_sats|default:'' }} sats Check your rewards portal to redeem or earn more.
{{ person.oshi_rewards_portal_url|default:'' }}
Referral Bonus Emails
These event-triggered emails are sent when a referred customer makes their first purchase, triggering Bitcoin rewards for both customers.
Visual Flow Setup
Here's exactly how your Klaviyo flow should look with the trigger splits:
💡 Flow Structure Explanation:
- Trigger: OSHI - Earned Referral Bonus Reward event
- First Split: referral_type equals "referral" (new customers)
- Second Split: referral_type equals "referrer" (referring customers)
- Default Path: referral_type equals "lifetime" (ongoing commissions)
Example Email Copy
Use these as starting points for your referral bonus emails. Customize the copy, branding, and design to match your voice and style. The trigger split will automatically route customers to the appropriate template based on their referral type.
Referring Customer Email
This email is sent to the customer who shared their referral link when their referred friend makes a purchase.
- Flow filter:
referral_type equals referrer
Email Content
You earned {{ event.referral_reward_sats|default:'' }} sats for your referral!
Your friend made a purchase - {{ event.referral_reward_btc|default:'' }} BTC added to your balance.
Great news! A friend made their first purchase using your referral link. As a thank you, we've added {{ event.referral_reward_sats|default:'' }} sats ({{ event.referral_reward_btc|default:'' }} BTC) to your rewards balance. Keep sharing your link to earn {{ event.program_referrer_commission_pct|default:'' }}% on every friend's first purchase! Your referral link: {{ person.oshi_referrals_reflink|default:'' }}
{{ person.oshi_rewards_portal_url|default:'' }}
Referred Customer Email
This email is sent to the new customer who used a referral link to make their first purchase.
- Flow filter:
referral_type equals referral
Email Content
Here's your {{ event.referral_reward_sats|default:'' }} sats referral bonus!
Welcome! Your {{ event.referral_reward_btc|default:'' }} BTC bonus is ready.
Welcome to our Bitcoin rewards program! Your referral bonus of {{ event.referral_reward_sats|default:'' }} sats ({{ event.referral_reward_btc|default:'' }} BTC) is now in your account. Share your referral link to earn more: {{ person.oshi_referrals_reflink|default:'' }}
{{ person.oshi_rewards_portal_url|default:'' }}
Lifetime Commission Email
This email is sent to existing customers who earn ongoing commission from their referred customers' purchases.
- Flow filter:
referral_type equals lifetime
Email Content
You earned {{ event.referral_reward_sats|default:'' }} sats commission!
Your referral made another purchase - {{ event.referral_reward_btc|default:'' }} BTC earned.
Great news! One of your referrals made another purchase and you've earned {{ event.referral_reward_sats|default:'' }} sats ({{ event.referral_reward_btc|default:'' }} BTC) in lifetime commission. {% catalog "oshi_rewards_config" %} You continue to earn {{ catalog_item.metadata.lifetime_commission_rate }}% on all their future purchases through our lifetime commission program. Keep sharing your referral link to build your earning network: {{ person.oshi_referrals_reflink|default:'' }} {% endcatalog %}
{{ person.oshi_rewards_portal_url|default:'' }}
Social Rewards Email
Send a single Klaviyo flow for any social engagement reward. No enrollment filter is needed — only enrolled customers can earn social rewards.
Example Email Copy
Use this as a starting point for your social engagement emails. Customize the copy, branding, and design to match your voice and style. The dynamic content will automatically show the correct platform-specific messaging.
Social Rewards Example
Dynamic template that automatically customizes content based on the social platform where the customer engaged.
Email Content
You earned {{ event.social_reward_sats|default:'' }} sats for following us on {{ event.social_platform|default:'' }}
Your rewards balance has been updated.
Thanks for engaging with us on {{ event.social_platform|default:'' }}! You've earned {{ event.social_reward_sats|default:'' }} sats ({{ event.social_reward_btc|default:'' }} BTC). Open your rewards portal anytime to view your balance and discover more ways to earn.
{{ event.reward_portal_url|default:'' }}



Examples of core Bitcoin rewards emails — purchase rewards, referral bonuses, and social engagement offers.
Engagement Emails (Recommended)
These are engagement + re-engagement touches that keep customers earning and redeeming between purchases. They’re optional, but they reliably drive lift when you keep cadence tight and copy short.
Reminder Emails
These time-delayed emails remind customers to claim their Bitcoin rewards before they expire. They work as part of your Purchase Rewards flow - specifically targeting the No branch (non-enrolled customers) to help increase enrollment rates.
Example Email Copy
Use these as starting points for your reminder emails. Customize the copy, branding, and urgency level to match your voice and style. These templates help convert non-enrolled customers by creating urgency around reward expiration.
15-Day Reminder
Gentle reminder for customers who earned Bitcoin rewards but haven't claimed them yet. This gives them time to discover and claim their rewards without pressure.
- Flow filter:
oshi_enrolled equals false
Email Content
Don't miss out on your {{ event.reward_sats_back|default:'' }} sats reward!
Your Bitcoin rewards are waiting - claim them before they expire.
You earned {{ event.reward_sats_back|default:'' }} sats from your recent purchase but haven't claimed them yet.
Your Bitcoin rewards are waiting! Create your account to claim them before they expire.
{{ person.oshi_rewards_portal_url|default:'' }}
30-Day Final Reminder
Friendly final notice for customers who still haven't claimed their Bitcoin rewards. This is their last opportunity before the rewards expire.
- Flow filter:
oshi_enrolled equals false
Email Content
Your {{ event.reward_sats_back|default:'' }} sats are about to expire
Your Bitcoin rewards are still waiting to be claimed.
Your {{ event.reward_sats_back|default:'' }} sats are still waiting to be claimed.
Don't forget about your Bitcoin rewards before they expire!
{{ person.oshi_rewards_portal_url|default:'' }}
Social Engagement Email
This email introduces newly enrolled customers to social earning opportunities. Send it within 3-7 days after enrollment to maximize engagement while the Bitcoin rewards program is still top-of-mind.
- Best timing: 3-7 days after
oshi_enrolled equals true
- Target audience: Recently enrolled customers only
Example Email Copy
Use this as a starting point for your social engagement emails. Simple template to encourage customers to follow you on social media.
Social Engagement Example
Simple email to encourage customers to follow you on social media and earn Bitcoin rewards.
Email Content
Follow us on social media and earn Bitcoin rewards
Earn Bitcoin rewards for following us on social media.
Follow us on social media and earn Bitcoin rewards! {% catalog "oshi_rewards_config" %} Follow and earn: Instagram: {{ catalog_item.metadata.social_instagram }} sats X (Twitter): {{ catalog_item.metadata.social_x }} sats YouTube: {{ catalog_item.metadata.social_youtube }} sats Facebook: {{ catalog_item.metadata.social_facebook }} sats Nostr: {{ catalog_item.metadata.social_nostr }} sats {% endcatalog %} Visit your rewards portal to start earning.
{{ person.oshi_rewards_portal_url|default:'' }}
Referral Engagement Email
Encourage enrolled customers to share their referral link and earn Bitcoin rewards for helping your brand grow. Send after customers have had time to experience your product and can authentically recommend it to friends.
- Best timing: 7-14 days after
oshi_enrolled equals true
- Target audience: Recently enrolled customers who have experienced the product
Example Email Copy
Use this as a starting point for your referral engagement emails. Simple template to encourage customers to share their referral link.
Referral Engagement Example
Simple email to encourage customers to share their referral link and earn Bitcoin rewards.
Email Content
Get paid in Bitcoin for sharing with friends
{% catalog "oshi_rewards_config" %}Earn {{ catalog_item.metadata.referrer_commission_rate }}% back in Bitcoin on every friend's purchase{% endcatalog %}
Help our brand grow and get paid in Bitcoin for every friend you refer! {% catalog "oshi_rewards_config" %} Here's how it works: • Share your unique referral link • Your friends get {{ catalog_item.metadata.referral_bonus_rate }}% back in Bitcoin on their first purchase • You earn {{ catalog_item.metadata.referrer_commission_rate }}% back in Bitcoin on every purchase they make • Plus {{ catalog_item.metadata.lifetime_commission_rate }}% ongoing commission on their future purchases Your referral link: {{ person.oshi_referrals_reflink|default:'' }} {% endcatalog %} Start sharing and start earning!
{{ person.oshi_referrals_reflink|default:'' }}



Examples of additional Bitcoin rewards emails — including social engagement, reward expiration reminders, and referral promotions.
Leveraging Customer Properties
Beyond basic reward emails, use the rich customer data to create engaging, personalized content blocks. These examples show how to leverage VIP status, program rates, and customer history for more compelling emails.
VIP Tier Progress
Show customers their VIP progress to motivate continued engagement and spending.
Text-Based VIP Progress
{% if person.oshi_vip_tier_next %} You're currently a {{ person.oshi_vip_tier_current|default:'' }} member earning {{ person.oshi_vip_tier_current_rate|default:'' }}% back! You're {{ person.oshi_vip_tier_progress_pct|default:'' }}% of the way to {{ person.oshi_vip_tier_next|default:'' }} tier. Spend just ${{ person.oshi_vip_tier_remaining_usd|default:'' }} more to unlock {{ person.oshi_vip_tier_next_rate|default:'' }}% back on all purchases! {% else %} Congratulations! You're at our highest {{ person.oshi_vip_tier_current|default:'' }} tier earning {{ person.oshi_vip_tier_current_rate|default:'' }}% back on all purchases! {% endif %}
HTML Progress Bar
<div style="background: #e5e7eb; border-radius: 10px; height: 20px; overflow: hidden; margin: 16px 20px; max-width: 400px; width: calc(100% - 40px); margin-left: auto; margin-right: auto;"> <div style="background: #3b82f6; height: 100%; width: {% if person.oshi_vip_tier_next %}{{ person.oshi_vip_tier_progress_pct|default:'0' }}{% else %}100{% endif %}%;"></div> </div>
VIP Program Information
Display all VIP tiers dynamically from your Klaviyo Catalog. The OSHI dashboard automatically syncs all program changes, so this information is always current.
VIP Tiers Overview
{% catalog "oshi_rewards_config" %} VIP Tier Rewards: {% if catalog_item.metadata.vip_tier_1_name %} {{ catalog_item.metadata.vip_tier_1_name }}: {{ catalog_item.metadata.vip_tier_1_rate }}% back (spend ${{ catalog_item.metadata.vip_tier_1_threshold }}+) {% endif %} {% if catalog_item.metadata.vip_tier_2_name %} {{ catalog_item.metadata.vip_tier_2_name }}: {{ catalog_item.metadata.vip_tier_2_rate }}% back (spend ${{ catalog_item.metadata.vip_tier_2_threshold }}+) {% endif %} {% if catalog_item.metadata.vip_tier_3_name %} {{ catalog_item.metadata.vip_tier_3_name }}: {{ catalog_item.metadata.vip_tier_3_rate }}% back (spend ${{ catalog_item.metadata.vip_tier_3_threshold }}+) {% endif %} {% if catalog_item.metadata.vip_tier_4_name %} {{ catalog_item.metadata.vip_tier_4_name }}: {{ catalog_item.metadata.vip_tier_4_rate }}% back (spend ${{ catalog_item.metadata.vip_tier_4_threshold }}+) {% endif %} {% if catalog_item.metadata.vip_tier_5_name %} {{ catalog_item.metadata.vip_tier_5_name }}: {{ catalog_item.metadata.vip_tier_5_rate }}% back (spend ${{ catalog_item.metadata.vip_tier_5_threshold }}+) {% endif %} {% endcatalog %}
Program Overview
Show customers all the ways they can earn rewards to encourage cross-engagement.
{% catalog "oshi_rewards_config" %} More ways to earn Bitcoin rewards: • You currently earn {{ person.oshi_vip_tier_current_rate|default:catalog_item.metadata.standard_rate }}% back on purchases • VIP members get up to {{ catalog_item.metadata.vip_max_rate }}% back • Pay with Bitcoin for an extra {{ catalog_item.metadata.bitcoin_payment_bonus_rate }}% bonus • Refer friends and earn {{ catalog_item.metadata.referrer_commission_rate }}% on their purchases • Your friends get {{ catalog_item.metadata.referral_bonus_rate }}% on their first purchase • Earn up to {{ catalog_item.metadata.social_total }} sats from social engagement {% endcatalog %}
Referral Stats
Celebrate customer referral success and encourage more sharing.
{% catalog "oshi_rewards_config" %} You've successfully referred {{ person.oshi_referrals_total_referred|default:'' }} friends to our Bitcoin rewards program. Keep sharing your link to earn {{ catalog_item.metadata.referrer_commission_rate }}% on every friend's first purchase! Your referral link: {{ person.oshi_referrals_reflink|default:'' }} {% endcatalog %}
Customer Overview
Show customers their complete rewards history and relationship with your business.
Total earned: {{ person.oshi_rewards_total_earned_sats|default:'' }} sats Current balance: {{ person.oshi_rewards_current_balance_sats|default:'' }} sats VIP status: {{ person.oshi_vip_tier_current|default:'' }} member Friends referred: {{ person.oshi_referrals_total_referred|default:'' }} people



Examples of personalized Bitcoin rewards emails that leverage customer properties such as VIP tiers, program overviews, and individual progress.
Personalization Fields Reference
Complete reference for all personalization fields available in Oshi rewards program emails. Fields are organized by data source for easier understanding and implementation.
💡 Data Source Guide
- Profile Fields → Customer's current status (use
person.field_name
) - Event Fields → Transaction-specific data (use
event.field_name
) - Catalog Fields → Program configuration (use
{% catalog %}
block)
Customer Profile Fields
Customer-specific data from their profile. These fields reflect the customer's current status, balances, and personal information.
💰 Rewards Balance
Total Earned (Sats)
{{ person.oshi_rewards_total_earned_sats|default:'' }}→ 35000
Total sats ever earned by customer from your business. Great for celebrating milestones and showing long-term value.
Total Earned (BTC)
{{ person.oshi_rewards_total_earned_btc|default:'' }}→ 0.00035
Total BTC earned (decimal format). Use alongside sats for customers who prefer BTC units.
Current Balance (Sats)
{{ person.oshi_rewards_current_balance_sats|default:'' }}→ 28000
Available sats balance for spending/redemption. Perfect for showing updated balances and encouraging redemption.
Current Balance (BTC)
{{ person.oshi_rewards_current_balance_btc|default:'' }}→ 0.00028
Available BTC balance (decimal format). Use for customers who think in BTC terms.
Rewards Portal URL
{{ person.oshi_rewards_portal_url|default:'' }}→ https://oshiapp.com/rewards/customer123
Customer's personal rewards dashboard URL. Use in CTA buttons to direct to balance and redemption page.
Enrollment Status
{{ person.oshi_enrolled|default:'' }}→ true
Boolean indicating if customer is enrolled in rewards program. Essential for flow filtering and conditional messaging.
👑 VIP Tier Status
Current VIP Tier
{{ person.oshi_vip_tier_current|default:'' }}→ Gold
Customer's current VIP tier name. Use to personalize messaging and show tier-specific benefits.
Current Tier Rate
{{ person.oshi_vip_tier_current_rate|default:'' }}→ 7
Percentage back the customer currently earns at their VIP tier. Show their current earning power.
VIP Tier Progress
{{ person.oshi_vip_tier_progress_pct|default:'' }}→ 60
Percentage progress toward next VIP tier (0-100). Perfect for progress bars and motivational messaging.
Next VIP Tier
{{ person.oshi_vip_tier_next|default:'' }}→ Platinum
Next achievable VIP tier name (null if at max tier). Use with conditional logic for progression messaging.
Next Tier Rate
{{ person.oshi_vip_tier_next_rate|default:'' }}→ 10
Percentage back at next VIP tier (null if at max tier). Show upgrade motivation and benefits.
Amount Needed for Next Tier
{{ person.oshi_vip_tier_remaining_usd|default:'' }}→ 600.00
Dollar amount needed to reach next VIP tier (null if at max tier). Create urgency and clear goals.
🔗 Referral Program
Total Referrals Made
{{ person.oshi_referrals_total_referred|default:'' }}→ 8
Total number of successful referrals this customer has made. Celebrate achievements and encourage more sharing.
Personal Referral Link
{{ person.oshi_referrals_reflink|default:'' }}→ https://oshiapp.com/referral/customer123
Customer's unique referral link. Essential for referral promotion - make sharing easy and trackable.
Event-Specific Fields
Data specific to the event that triggered the email (purchase, social engagement, referral). These fields contain transaction-specific information.
💳 Purchase Transaction Fields
Sats Earned (This Transaction)
{{ event.reward_sats_back|default:'' }}→ 1538
Sats earned from THIS specific transaction. Use to celebrate the customer's reward and show exact amount earned.
BTC Earned (This Transaction)
{{ event.reward_btc_back|default:'' }}→ 0.00001538
BTC earned from THIS transaction (decimal format). Perfect for showing BTC equivalent alongside sats.
Transaction Reward Portal URL
{{ event.reward_portal_url|default:'' }}→ https://oshiapp.com/rewards/customer123
Link to customer's rewards portal for this specific transaction. Use in CTA buttons for claiming rewards.
📱 Social Engagement Fields
Social Platform
{{ event.social_platform|default:'' }}→ Instagram
Platform where engagement occurred (Instagram, X, Facebook, YouTube, Nostr). Personalize messaging by platform.
Social Reward Sats
{{ event.social_reward_sats|default:'' }}→ 250
Sats earned from social engagement. Show customers exactly how much they earned for following/sharing.
Social Reward BTC
{{ event.social_reward_btc|default:'' }}→ 0.00000250
BTC equivalent of social engagement rewards. Display alongside sats for clarity.
🎁 Referral Event Fields
Referral Type
{{ event.referral_type|default:'' }}→ referrer
Either "referrer", "referral", or "lifetime". Essential for flow filtering and personalized messaging.
Referral Reward Sats
{{ event.referral_reward_sats|default:'' }}→ 1000
Sats earned from referral activity. Show specific bonus amount in referrer and referred customer emails.
Referral Reward BTC
{{ event.referral_reward_btc|default:'' }}→ 0.00001000
BTC equivalent of referral rewards. Display alongside sats for multiple value perspectives.
Event Referral Link
{{ event.referral_reflink|default:'' }}→ https://oshi.link/customer123
Referral link associated with this specific transaction. Show which link was used in confirmation emails.
🏆 VIP Context (Event Snapshot)
VIP Tier at Transaction
{{ event.vip_tier_current|default:'' }}→ Gold
Customer's VIP tier at time of this transaction. Shows historical context for the reward earned.
VIP Rate at Transaction
{{ event.vip_tier_current_rate|default:'' }}→ 7
VIP rate that applied to this transaction. Explain why they earned this specific amount.
VIP Progress at Transaction
{{ event.vip_progress_pct|default:'' }}→ 65
VIP tier progress at time of transaction. Show how this purchase moved them closer to next tier.
Amount Still Needed (at Transaction)
{{ event.vip_remaining_usd|default:'' }}→ 350.00
Amount needed for next tier at transaction time. Create urgency for additional purchases.
Program Configuration (Catalog)
Program configuration data from your Klaviyo catalog. Always use within {% catalog "oshi_rewards_config" %}
blocks. These update automatically when you change program settings.
Usage Pattern:
{% catalog "oshi_rewards_config" %}
Standard rate: {{ catalog_item.metadata.standard_rate }}%
VIP max rate: {{ catalog_item.metadata.vip_max_rate }}%
{% endcatalog %}
💎 Core Program Rates
Standard Purchase Rate
{{ catalog_item.metadata.standard_rate }}→ 3
Default percentage back on purchases for regular customers. Use to promote purchase rewards across all email types.
Bitcoin Payment Bonus Rate
{{ catalog_item.metadata.bitcoin_payment_bonus_rate }}→ 1
Extra percentage earned when customers pay with Bitcoin. Promote Bitcoin payments and show additional earning opportunity.
Referral Bonus Rate
{{ catalog_item.metadata.referral_bonus_rate }}→ 10
Percentage new customers get on their first purchase. Encourage referral sharing by showing friend benefits.
Referrer Commission Rate
{{ catalog_item.metadata.referrer_commission_rate }}→ 8
Percentage referrers earn when friends make purchases. Motivate referral sharing with earning potential.
Lifetime Commission Rate
{{ catalog_item.metadata.lifetime_commission_rate }}→ 7
Ongoing commission percentage for lifetime referrals. Show long-term earning potential for quality referrals.
👑 VIP Program Configuration
VIP Maximum Rate
{{ catalog_item.metadata.vip_max_rate }}→ 10
Highest percentage available through VIP tiers. Use to show ultimate earning potential.
VIP Tier 1 (Bronze)
{{ catalog_item.metadata.vip_tier_1_name }}→ Bronze
{{ catalog_item.metadata.vip_tier_1_rate }}→ 3
{{ catalog_item.metadata.vip_tier_1_threshold }}→ 0
Tier 1 name, rate, and minimum spend threshold. Use to show VIP tier structure and entry requirements.
VIP Tier 2 (Silver)
{{ catalog_item.metadata.vip_tier_2_name }}→ Silver
{{ catalog_item.metadata.vip_tier_2_rate }}→ 5
{{ catalog_item.metadata.vip_tier_2_threshold }}→ 100
Tier 2 configuration. Perfect for showing progression path and next tier benefits.
VIP Tier 3 (Gold)
{{ catalog_item.metadata.vip_tier_3_name }}→ Gold
{{ catalog_item.metadata.vip_tier_3_rate }}→ 7
{{ catalog_item.metadata.vip_tier_3_threshold }}→ 300
Tier 3 configuration. Use for mid-tier messaging and progression motivation.
VIP Tier 4 (Platinum)
{{ catalog_item.metadata.vip_tier_4_name }}→ Platinum
{{ catalog_item.metadata.vip_tier_4_rate }}→ 10
{{ catalog_item.metadata.vip_tier_4_threshold }}→ 1000
Tier 4 configuration. Show premium benefits and high-value customer rewards.
VIP Tier 5 (Diamond)
{{ catalog_item.metadata.vip_tier_5_name }}→ Diamond
{{ catalog_item.metadata.vip_tier_5_rate }}→ 10
{{ catalog_item.metadata.vip_tier_5_threshold }}→ 2500
Highest tier configuration. Celebrate top-tier customers and show exclusive benefits.
📱 Social Rewards Configuration
Instagram Rewards
{{ catalog_item.metadata.social_instagram }}→ 250
Sats reward for Instagram engagement. Use to promote Instagram following and engagement.
X (Twitter) Rewards
{{ catalog_item.metadata.social_x }}→ 200
Sats reward for X engagement. Encourage Twitter/X following and sharing.
Facebook Rewards
{{ catalog_item.metadata.social_facebook }}→ 150
Sats reward for Facebook engagement. Promote Facebook page engagement.
YouTube Rewards
{{ catalog_item.metadata.social_youtube }}→ 300
Sats reward for YouTube engagement. Encourage channel subscriptions and video engagement.
Nostr Rewards
{{ catalog_item.metadata.social_nostr }}→ 500
Sats reward for Nostr engagement. Promote Nostr following for Bitcoin-native audience.
Total Social Rewards
{{ catalog_item.metadata.social_total }}→ 1400
Total sats available across all social platforms. Show complete earning potential from social engagement.
🎛️ Feature Flags
VIP Program Enabled
{{ catalog_item.metadata.vip_enabled }}→ true
Boolean controlling VIP tier messaging in emails. Use for conditional VIP content display.
Bitcoin Bonus Enabled
{{ catalog_item.metadata.bitcoin_bonus_enabled }}→ true
Boolean controlling Bitcoin payment bonus messaging. Use for conditional Bitcoin promotion.
Referral Program Enabled
{{ catalog_item.metadata.referral_enabled }}→ true
Boolean controlling referral program messaging. Use for conditional referral content.
Social Rewards Enabled
{{ catalog_item.metadata.social_enabled }}→ true
Boolean controlling social rewards messaging. Use for conditional social engagement promotion.
Advanced Usage Patterns
🎯 Flow Filtering Strategies
Enrollment Status Filtering
{{ person.oshi_enrolled }} equals true
Split flows between enrolled and non-enrolled customers for different messaging.
Referral Type Filtering
{{ event.referral_type }} equals "referrer"
Separate referrer rewards from referral bonuses with different email content.
VIP Tier Filtering
{{ person.oshi_vip_tier_current }} equals "Platinum"
Create tier-specific flows for personalized VIP messaging.
Social Platform Filtering
{{ event.social_platform }} equals "Instagram"
Customize social reward emails by platform for relevant messaging.
🔄 Cross-Promotion Strategies
Purchase Email → Referral Promotion
{% catalog "oshi_rewards_config" %}
Share your link and earn {{ catalog_item.metadata.referrer_commission_rate }}% on friends' purchases!
{% endcatalog %}
Use purchase emails to promote referral earning opportunities.
Social Email → VIP Tier Promotion
{% catalog "oshi_rewards_config" %}
VIP members earn up to {{ catalog_item.metadata.vip_max_rate }}% on purchases!
{% endcatalog %}
Use social reward emails to promote VIP tier benefits.
Dynamic Rate Display
You currently earn {{ person.oshi_vip_tier_current_rate|default:catalog_item.metadata.standard_rate }}% back
Show personalized rates falling back to standard rate for non-VIP customers.
🛡️ Best Practices
- Always use defaults:
|default:''
prevents empty fields from breaking emails - Combine sats + BTC: "{{ event.reward_sats_back }} sats ({{ event.reward_btc_back }} BTC)" for clarity
- Conditional VIP messaging: Use
{% if person.oshi_vip_tier_next %}
for progression vs max tier celebration - Always current rates: The OSHI dashboard automatically syncs all program changes to the catalog, so email content is always accurate
- Use feature flags: Control content visibility with
{% if catalog_item.metadata.vip_enabled %}
- Test edge cases: Max VIP tier (null values), non-enrolled users, first-time customers
Wrapping Up
You now have the playbook for building Bitcoin-powered loyalty flows in Klaviyo — from core reward emails to engagement nudges and personalized VIP content. With Oshi sending real-time reward events into Klaviyo, you can design flows that not only inform your customers but also motivate them to keep earning, redeeming, and coming back.
Follow our integration guide to connect Oshi to Klaviyo if you haven't already.

What’s Next?
Now that Oshi is connected to Klaviyo, it’s time to make sure your customers only receive emails from the source you control.
In your Oshi Dashboard, you can:
- Disable default Oshi emails that you’ll now manage through Klaviyo.
- Keep any emails you still want Oshi to send directly.
- Decide exactly which messages should run through Klaviyo for full branding and customization.
This step prevents duplicate emails and ensures your rewards program feels seamless to customers.
Head back to your Oshi Dashboard, update your email settings, and put Klaviyo in charge of your rewards flows.