How to Build Omnisend Loyalty Automations with Oshi Bitcoin Rewards
Last updated March 4, 2026
Before You Start
This guide is for merchants who have already connected Oshi to Omnisend. If you haven't done that yet, follow our integration guide first.
Once connected, Oshi automatically pushes reward activity — purchases, referrals, social engagement, affiliate commissions, and more — directly into Omnisend as custom events. This guide will show you how to turn that data into powerful automations.
By the end, you'll know how to:
- Build core automations (purchase rewards, referral bonuses, social rewards, affiliate commissions)
- Add engagement automations (reminders, social engagement invites, referral engagement)
- Leverage contact custom properties for personalized content blocks (VIP status, referral stats, tier progress)
- Reference all available personalization fields for rewards emails
How Omnisend Automations Work with Oshi
Oshi sends data to Omnisend as custom events. Each event carries two types of data you can use in your emails:
- Event properties — data specific to the trigger event (e.g.,
[[event.reward_sats_back]]) - Contact custom properties — data synced to the contact profile and updated over time (e.g.,
[[contact.custom_properties.oshi_rewards_current_balance_sats]])
When you connect Oshi, test events are sent automatically so all custom events appear in the automation trigger dropdown immediately.
| What you want | Omnisend syntax |
|---|---|
| Event property | [[event.property_name]] |
| Contact custom property | [[contact.custom_properties.property_name]] |
| Conditional block | [% if event.property == "value" %] ... [% endif %] |
| Fallback value | [[event.property_name | default: '']] |
| Contact first name | [[contact.firstName]] |
Core Automations
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.
Purchase Reward Emails
These event-triggered emails are sent when a customer earns Bitcoin rewards on a purchase. Use a Conditional Split so the message and CTA fit their enrollment status.
Purchase Reward Emails
Use these as starting points for your purchase reward emails. Customize the copy, branding, and design to match your voice and style. The template fields will automatically populate with your customer's specific reward data.
Enrolled Customer (Reward Earned)
Send this to customers who are already enrolled in the rewards program. The goal is to show their reward and encourage continued engagement.
- Branch: TRUE (
oshi_enrolled equals true)
Email Content
[[event.reward_sats_back]] sats added to your balance
Your balance is updated. See what you can do next.
Hi [[contact.firstName]], Great news — your recent purchase earned you Bitcoin rewards! 🟠 Sats earned: [[event.reward_sats_back]] sats ₿ BTC value: [[event.reward_btc_back]] BTC [% if event.vip_tier_current %] Your current tier: [[event.vip_tier_current]] ([[event.vip_tier_current_rate]]% back) [% endif %] [% if event.vip_tier_next %] You're [[event.vip_remaining_usd | default: '']] away from [[event.vip_tier_next]] status ([[event.vip_tier_next_rate]]% back on every purchase). [% endif %] Check your rewards portal to redeem or earn more.
[[event.reward_portal_url]]
Non-Enrolled Customer (Invitation)
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.
- Branch: FALSE (
oshi_enrolled does not equal true)
Email Content
You've earned [[event.reward_sats_back]] sats — Claim your Bitcoin rewards
Claim your [[event.reward_btc_back]] BTC before it expires.
Hi [[contact.firstName]], You just earned [[event.reward_sats_back]] sats ([[event.reward_btc_back]] BTC) in Bitcoin rewards on your recent purchase — but they haven't been claimed yet. Your sats will expire in 30 days if unclaimed. Join the Oshi rewards program now to lock them in and keep earning on every order.
[[event.reward_portal_url]]
Referral Bonus Emails
Oshi uses two separate event names for referral rewards — one for the person who referred and one for the new customer. Each event is sent to the correct recipient automatically, so you build two separate automations (no Conditional Split needed).
Referral Bonus Emails
Each referral type gets its own automation with a single email step. Customize the copy, branding, and design to match your voice and style.
Referrer Reward Email
Sent to the customer who shared their referral link when their referred friend makes a purchase.
Email Content
You earned a referral bonus — [[event.referral_reward_sats]] sats!
Your friend made a purchase — [[event.referral_reward_btc]] BTC added to your balance.
Hi [[contact.firstName]], Someone used your referral link to make their first purchase, and you just earned a bonus! 🟠 Your referral bonus: [[event.referral_reward_sats]] sats ([[event.referral_reward_btc]] BTC) Keep sharing your referral link to earn more: [[event.referral_reflink]]
[[event.reward_portal_url]]
Referred Customer Reward Email
Sent to the new customer who used a referral link to make their first purchase.
Email Content
Welcome! You earned [[event.referral_reward_sats]] sats just for joining
Welcome! Your [[event.referral_reward_btc]] BTC bonus is ready.
Hi [[contact.firstName]], Welcome! Because you joined through a referral, you've already earned Bitcoin rewards. 🟠 Welcome bonus: [[event.referral_reward_sats]] sats ([[event.referral_reward_btc]] BTC) Now earn even more — share your own referral link: [[contact.custom_properties.referral_code]]
[[event.reward_portal_url]]
Affiliate Commission Emails
These event-triggered emails are sent when affiliates earn ongoing commission from their referred customers' purchases. This is separate from the one-time referral bonus — affiliate commissions are earned on every future purchase made by referred customers.
Affiliate Commission Email
Use this as a starting point for your affiliate commission emails. Customize the copy, branding, and design to match your voice and style.
Affiliate Commission Email
Sent when an affiliate earns commission from a referred customer's purchase.
Email Content
Commission earned — [[event.affiliate_reward_sats]] sats
Your referral made a purchase — [[event.affiliate_reward_btc]] BTC earned.
Hi [[contact.firstName]], You just earned an affiliate commission! 🟠 Commission: [[event.affiliate_reward_sats]] sats ([[event.affiliate_reward_btc]] BTC) You continue to earn [[event.program_lifetime_commission_pct]]% on all their future purchases through our affiliate program. Your affiliate link: [[event.affiliate_reflink]] Keep sharing to earn more commissions on every qualifying sale.
[[event.reward_portal_url]]
Social Rewards Email
All social platform rewards use a single event name. Use a Conditional Split on social_platform to send platform-specific messaging, or keep it simple with a single generic template.
Social Rewards Email
Use this as a starting point for your social engagement emails. The dynamic content will automatically show the correct platform name and reward amount.
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]] sats for engaging on [[event.social_platform]]!
Your rewards balance has been updated.
Hi [[contact.firstName]], Thank you for engaging on [[event.social_platform]]! 🟠 Sats earned: [[event.social_reward_sats]] sats ([[event.social_reward_btc]] BTC) There are more ways to earn Bitcoin with Oshi: • Instagram: [[event.program_social_instagram_sats]] sats • X: [[event.program_social_x_sats]] sats • Facebook: [[event.program_social_facebook_sats]] sats • YouTube: [[event.program_social_youtube_sats]] sats • Nostr: [[event.program_social_nostr_sats]] sats
[[event.reward_portal_url]]
Engagement Automations (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 non-enrolled customers to claim their Bitcoin rewards before they expire. Add them as Wait steps in the FALSE branch of your Purchase Reward automation.
Reminder Emails
Use these to 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.
Email Content
Don't miss out on your [[event.reward_sats_back]] sats reward!
Your Bitcoin rewards are waiting — claim them before they expire.
Hi [[contact.firstName]], A reminder — you still have [[event.reward_sats_back]] sats waiting to be claimed from your recent purchase. You have about 15 days left before they expire. Claim them now and start earning Bitcoin on every order.
[[event.reward_portal_url]]
30-Day Final Reminder
Final notice before the rewards expire. Sent 30 days after the original purchase (15 days after the first reminder).
Email Content
Your sats are about to expire
Your Bitcoin rewards are still waiting to be claimed.
Hi [[contact.firstName]], This is your last chance — your [[event.reward_sats_back]] sats reward is expiring soon. Don't let your Bitcoin rewards go to waste. Claim them today.
[[event.reward_portal_url]]
Social Engagement Email
This email introduces newly enrolled customers to social earning opportunities. Add it as a delayed step in your Purchase Reward automation's TRUE branch, 3–7 days after the reward earned email.
- Best timing: 3–7 days after enrollment (TRUE branch of Purchase Reward automation)
- Target audience: Recently enrolled customers only
Social Engagement Email
Simple template to encourage enrolled customers to follow you on social media and earn Bitcoin rewards.
Social Engagement Example
Encourage customers to follow you on social media and earn Bitcoin rewards.
Email Content
Earn even more Bitcoin — follow us on social media
Earn Bitcoin rewards for following us on social media.
Hi [[contact.firstName]], You're already earning Bitcoin on every purchase. Did you know you can also earn sats just for following us on social media? Here's what's available: • Instagram: [[event.program_social_instagram_sats]] sats • X: [[event.program_social_x_sats]] sats • Facebook: [[event.program_social_facebook_sats]] sats • YouTube: [[event.program_social_youtube_sats]] sats • Nostr: [[event.program_social_nostr_sats]] sats Total available: [[event.program_social_rewards_total]] sats
[[event.reward_portal_url]]
Referral Engagement Email
Encourage enrolled customers to share their referral link and earn Bitcoin rewards for helping your brand grow. Add as a delayed step in your Purchase Reward automation's TRUE branch, 7–14 days after the reward earned email.
- Best timing: 7–14 days after enrollment
- Target audience: Recently enrolled customers who have experienced the product
Referral Engagement Email
Simple template to encourage customers to share their referral link.
Referral Engagement Example
Encourage customers to share their referral link and earn Bitcoin rewards.
Email Content
Share the love — earn Bitcoin for every friend you refer
Earn [[event.program_referrer_commission_pct]]% back in Bitcoin on every friend's purchase
Hi [[contact.firstName]], Love earning Bitcoin on your purchases? Share it with a friend and earn a bonus when they make their first order. Your referral link: [[contact.custom_properties.referral_code]] Your current Bitcoin balance: [[contact.custom_properties.oshi_rewards_current_balance_sats]] sats
[[event.reward_portal_url]]
Leveraging Contact Custom Properties
Beyond basic reward emails, use the rich customer data to create engaging, personalized content blocks. Contact properties are updated every time Oshi syncs a customer's profile. Use them to show current balances and status in any email, even outside of event-triggered automations.
VIP Tier Progress
Show customers their VIP progress to motivate continued engagement and spending.
Text-Based VIP Progress
[% if event.vip_tier_next %] You're currently a [[contact.custom_properties.vip_tier]] member earning [[event.vip_tier_current_rate]]% back! You're [[event.vip_progress_pct]]% of the way to [[event.vip_tier_next]] tier. Spend just $[[event.vip_remaining_usd]] more to unlock [[event.vip_tier_next_rate]]% back on all purchases! [% else %] Congratulations! You're at our highest [[contact.custom_properties.vip_tier]] tier earning [[event.vip_tier_current_rate]]% 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;"> <div style="background: #3b82f6; height: 100%; width: [% if event.vip_tier_next %][[event.vip_progress_pct | default: '0']][% else %]100[% endif %]%;"></div> </div>
VIP Program Information
Unlike Klaviyo's catalog blocks, Omnisend uses flat program_* fields on each event. For a full tier breakdown, hardcode tier names/thresholds in your email and update them if your program changes.
[% if event.vip_tier_current %] Your VIP Status: [[event.vip_tier_current]] — [[event.vip_tier_current_rate]]% back on every purchase [% if event.vip_tier_next %] Next tier: [[event.vip_tier_next]] — [[event.vip_tier_next_rate]]% back Spend $[[event.vip_remaining_usd]] more to upgrade! [% endif %] [% endif %]
Program Overview
Show customers all the ways they can earn rewards using flat program_* event fields.
More ways to earn Bitcoin rewards: • VIP members earn up to [[event.program_vip_max_rate]]% back on purchases • Refer friends and earn [[event.program_referrer_commission_pct]]% on their purchases • Earn up to [[event.program_social_rewards_total]] sats from social engagement
Referral Stats & Customer Overview
Show customers their complete rewards overview using contact custom properties.
Current balance: [[contact.custom_properties.oshi_rewards_current_balance_sats]] sats VIP tier: [[contact.custom_properties.vip_tier]] Referral code: [[contact.custom_properties.referral_code]]
Personalization Fields Reference
Complete reference for all personalization fields available in Oshi rewards emails for Omnisend.
Data Source Guide
- Contact Custom Properties →
[[contact.custom_properties.field_name]] - Event Fields →
[[event.field_name]]
Contact Custom Properties
Always available in any email, not just event-triggered automations.
Contact Properties
Current Sats Balance
[[contact.custom_properties.oshi_rewards_current_balance_sats]]→ 28000
Current sats balance.
VIP Tier
[[contact.custom_properties.vip_tier]]→ Gold
Current VIP tier name.
Referral Code
[[contact.custom_properties.referral_code]]→ https://oshi.link/sarah123
Customer's unique referral link.
Enrolled Status
[[contact.custom_properties.oshi_enrolled]]→ true
Boolean indicating if enrolled.
Purchase Reward Event Fields
Available on Oshi: Purchase Reward.
💳 Purchase Fields
Sats Earned
[[event.reward_sats_back]]→ 2500
Total sats earned.
BTC Earned
[[event.reward_btc_back]]→ 0.000025
BTC equivalent.
Rewards Portal URL
[[event.reward_portal_url]]→ https://oshiapp.com/rewards/...
Direct link to claim rewards.
Enrolled Status
[[event.oshi_enrolled]]→ true
Use in Conditional Split.
🏆 VIP Context
Current VIP Tier
[[event.vip_tier_current]]→ Gold
Current Tier Rate
[[event.vip_tier_current_rate]]→ 7
Next VIP Tier
[[event.vip_tier_next]]→ Platinum
Next Tier Rate
[[event.vip_tier_next_rate]]→ 10
Spend to Next Tier
[[event.vip_remaining_usd]]→ 195.00
VIP Progress %
[[event.vip_progress_pct]]→ 85
Referral Reward Event Fields
Available on Oshi: Referral - Referrer Reward and Oshi: Referral - Referred Customer Reward.
🎁 Referral Fields
Referral Type
[[event.referral_type]]→ "Referrer" or "Referred Customer"
Capitalized. Each type has its own event.
Sats Earned
[[event.referral_reward_sats]]→ 1000
BTC Earned
[[event.referral_reward_btc]]→ 0.00001
Rewards Portal URL
[[event.reward_portal_url]]
Referral Link
[[event.referral_reflink]]
Referrer Commission %
[[event.program_referrer_commission_pct]]→ 8
Referred Reward %
[[event.program_referral_commission_pct]]→ 10
Lifetime Commission %
[[event.program_lifetime_commission_pct]]→ 7
Social Reward Event Fields
Available on Oshi: Social Reward.
📱 Social Fields
Platform
[[event.social_platform]]→ Instagram
Values: Instagram, X, Facebook, YouTube, Nostr, TikTok.
Sats Earned
[[event.social_reward_sats]]→ 250
BTC Earned
[[event.social_reward_btc]]→ 0.0000025
Rewards Portal URL
[[event.reward_portal_url]]
Instagram Sats
[[event.program_social_instagram_sats]]→ 250
X Sats
[[event.program_social_x_sats]]→ 200
Facebook Sats
[[event.program_social_facebook_sats]]→ 150
YouTube Sats
[[event.program_social_youtube_sats]]→ 300
Nostr Sats
[[event.program_social_nostr_sats]]→ 500
Total Social Rewards
[[event.program_social_rewards_total]]→ 1400
Max VIP Rate
[[event.program_vip_max_rate]]→ 10
Affiliate Commission Event Fields
Available on Oshi: Affiliate Commission.
🏦 Affiliate Fields
Sats Earned
[[event.affiliate_reward_sats]]→ 3200
BTC Earned
[[event.affiliate_reward_btc]]→ 0.000032
Rewards Portal URL
[[event.reward_portal_url]]
Affiliate Link
[[event.affiliate_reflink]]
Troubleshooting
Custom events don't appear in the trigger dropdown
Oshi sends test events automatically when you connect the integration. If events are missing, go to Integrations → Omnisend in your Oshi dashboard and use the Send Test Events button to resend them.
Template variables show as blank
Check that you are using [[event.property_name]] (double square brackets) and not {{ }}. Also confirm the event has fired at least once with that property — preview mode uses the most recent event data.
Conditional Split not routing correctly
Verify the exact value you are matching, including capitalization. For example, social_platform values are "Instagram", "X", "Facebook", "YouTube", "Nostr", "TikTok" — not lowercase.
Contact properties are outdated
Contact properties are synced when Oshi processes a reward event. For bulk updates, contact Oshi support to trigger a manual resync of your customer list.
Related Articles
Was this article helpful?