Use Rivo events to build Klaviyo flows around loyalty earnings, referrals, memberships, cashback, and more. This reference covers all 38 named metrics and the information each can carry, including metrics with delivery limitations.
​

Connect Klaviyo and switch the integration ON. Your account must have access to Klaviyo events. Enable each available event you need under Custom Events Trigger , then save. Event switches start off. Program-specific events also need the corresponding program and qualifying customer activity. If a setting is missing, contact your Rivo point of contact to check availability.
​

For connection instructions, see Klaviyo integration.
​

Availability exceptions: Membership Payment Success, Loyalty Gift Processed, and Virtual Gift Card Reminder are included for reference, but do not currently have normal automatic delivery. Read their individual availability notes before building a flow. Seeing a metric or sample event in Klaviyo does not prove that future customer actions will trigger it.
​

Rivo needs a Klaviyo profile for the customer receiving a live event. It uses an existing profile ID or attempts to sync the profile first. If it cannot obtain that ID, it does not send the live event. Profile synchronization does not replay historical events.
​

Event properties describe the activity that triggered an event. Rivo profile properties, such as the customer’s current points balance, are synced separately. A customer ID listed in an event identifies the Shopify customer; it is separate from the Klaviyo profile ID.
​

Some event properties are optional or can be blank when the information is unavailable. Amounts formatted as currency use your store’s money format. Dates use the formats described below.
​

Earned events describe approved earnings; Pending events describe earnings awaiting approval. The matching event switch is required for each. Manual adjustments, imports, resets, migrations, point purchases, and POS adjustments are excluded unless manual earning events are allowed for your integration. Expiry and revoked earnings are excluded. Negative point changes are excluded from the Points events. Zero earnings and points or credits awarded through Drops do not generate these automatic events. CSV updates can suppress Klaviyo events even when manual earning events are allowed.
​

Triggered when a qualifying loyalty earning is approved. Requires a qualifying earning action and Points Earned enabled.

Event property

Meaning and availability

trigger_name

Name of the earning action. Custom actions and visit-a-URL actions use their configured completion text.

earnings_amount

Amount associated with this earning, not the customer’s total balance.

next_vip_tier_threshold

Next VIP tier qualification threshold, as a whole number; 0 when there is no next tier or VIP tiers are disabled.

needed_for_next_vip_tier

Remaining qualification amount (spend, earnings, or qualifying product count) needed for the next VIP tier, according to your VIP qualification method; 0 when unavailable.

Triggered when an earning is created awaiting approval. Requires delayed approval and Points Pending enabled. Approval can later generate the separate Earned event.

Event property

Meaning and availability

trigger_name

Name of the earning action. Custom actions and visit-a-URL actions use their configured completion text.

earnings_amount

Amount associated with this earning, not the customer’s total balance.

next_vip_tier_threshold

Next VIP tier qualification threshold, as a whole number; 0 when there is no next tier or VIP tiers are disabled.

needed_for_next_vip_tier

Remaining qualification amount (spend, earnings, or qualifying product count) needed for the next VIP tier, according to your VIP qualification method; 0 when unavailable.

Triggered when qualifying credit earnings are approved. Requires credit earning events to be available for your account and Credits Earned enabled.
​

Gift-card credit earnings include the credit code when available. Earnings without an expiry do not include an expiry date.

Event property

Meaning and availability

trigger_name

Name of the earning action. Custom actions and visit-a-URL actions use their configured completion text.

earnings_amount

Amount associated with this earning, not the customer’s total balance.

next_vip_tier_threshold

Next VIP tier qualification threshold, as a whole number; 0 when there is no next tier or VIP tiers are disabled.

needed_for_next_vip_tier

Remaining qualification amount (spend, earnings, or qualifying product count) needed for the next VIP tier, according to your VIP qualification method; 0 when unavailable.

formatted_earnings_amount

Earning amount in your store’s money format.

loyalty_card_code

Optional: included for gift-card credit earnings; blank if no credit code is available.

reward_expiration_date

Optional: included when this earning has an expiry date, as YYYY-MM-DD.

Triggered when credit earnings are created awaiting approval. Requires delayed approval, credit earning events available for your account, and Credits Pending enabled.
​

The credit code applies to gift-card credit only and may be blank. Earnings without an expiry do not include an expiry date. Pending amounts are not yet available to spend.

Event property

Meaning and availability

trigger_name

Name of the earning action. Custom actions and visit-a-URL actions use their configured completion text.

earnings_amount

Amount associated with this earning, not the customer’s total balance.

next_vip_tier_threshold

Next VIP tier qualification threshold, as a whole number; 0 when there is no next tier or VIP tiers are disabled.

needed_for_next_vip_tier

Remaining qualification amount (spend, earnings, or qualifying product count) needed for the next VIP tier, according to your VIP qualification method; 0 when unavailable.

formatted_earnings_amount

Earning amount in your store’s money format.

loyalty_card_code

Optional: included for gift-card credit earnings; blank if no credit code is available.

reward_expiration_date

Optional: included when this earning has an expiry date, as YYYY-MM-DD.

​

Triggered when a customer moves to a higher VIP tier. Requires VIP tiers and Customer Moves Up A Tier enabled.

Event property

Meaning and availability

vip_tier_name

Name of the tier the customer has entered.

next_vip_tier_threshold

Next VIP tier qualification threshold, as a whole number; 0 when there is no next tier or VIP tiers are disabled.

needed_for_next_vip_tier

Remaining qualification amount (spend, earnings, or qualifying product count) needed for the next VIP tier, according to your VIP qualification method; 0 when unavailable.

next_vip_tier_name

Name of the next available tier; blank at the highest tier or when unavailable.

Triggered when a customer moves to a lower VIP tier. Requires VIP tiers and Customer Moves Down A Tier enabled.

Event property

Meaning and availability

vip_tier_name

Name of the tier the customer has entered.

next_vip_tier_threshold

Next VIP tier qualification threshold, as a whole number; 0 when there is no next tier or VIP tiers are disabled.

needed_for_next_vip_tier

Remaining qualification amount (spend, earnings, or qualifying product count) needed for the next VIP tier, according to your VIP qualification method; 0 when unavailable.

next_vip_tier_name

Name of the next available tier; blank at the highest tier or when unavailable.

​

Triggered when a customer redeems for a reward. Requires a reward redemption and Reward Redeemed enabled.

Event property

Meaning and availability

reward_name

Reward name; blank if unavailable.

reward_code

Issued reward code; blank if unavailable.

reward_tos

Reward terms as text; blank if no terms apply or no reward is available.

Triggered when birthday earnings are awarded. Requires a qualifying birthday earning action and Celebrate Birthday enabled. This is separate from capturing a date of birth.

Event property

Meaning and availability

earnings_amount

Birthday earning amount: whole number for points, decimal amount for credits.

Triggered when a customer’s birthday is first added, rather than on later birthday edits. Requires Birthday Captured enabled.

Event property

Meaning and availability

dob

Captured birthday in month-day format (MM-DD).

captured_at

Timestamp when the birthday was updated; can be blank if unavailable.

Requires the applicable reward, points, or credit expiry setup and the matching Klaviyo notification switch. Warning and Last Chance are separate reminder stages, normally 30 days and three days before expiry. Reward reminders require an unused expiring reward; points and credits reminders require eligible expiring earnings. The Klaviyo event switch is separate from Rivo’s native email switch. Use the exact metric names below: all Last Chance metrics include Expiry. The event properties do not contain a reward code or the customer’s full balance.
​

Triggered at the expiry warning stage for an expiring redeemed reward. Requires reward expiry and Notification Reward Expiry Warning enabled.

Event property

Meaning and availability

reward_name

Name of the expiring reward; blank if unavailable.

time_until_expiry

Approximate time until expiry in hours or days, such as 3 days. This is display text, not an exact duration.

expiry_date

Expiry date in day-with-suffix format, such as 3rd Oct 2026.

expiry_date_formatted

Expiry date using your store’s configured date format and time zone.

Triggered at the last-chance expiry reminder stage for an expiring redeemed reward. Requires reward expiry and Notification Reward Expiry Last Chance enabled.

Event property

Meaning and availability

reward_name

Name of the expiring reward; blank if unavailable.

time_until_expiry

Approximate time until expiry in hours or days, such as 3 days. This is display text, not an exact duration.

expiry_date

Expiry date in day-with-suffix format, such as 3rd Oct 2026.

expiry_date_formatted

Expiry date using your store’s configured date format and time zone.

Triggered at the expiry warning stage for points. Requires points expiry and Notification Points Expiry Warning enabled.
​

Points expiry notifications do not include an expiring-points amount.

Event property

Meaning and availability

time_until_expiry

Approximate time until expiry in hours or days, such as 3 days. This is display text, not an exact duration.

expiry_date

Expiry date in day-with-suffix format, such as 3rd Oct 2026.

expiry_date_formatted

Expiry date using your store’s configured date format and time zone.

Triggered at the last-chance expiry reminder stage for points. Requires points expiry and Notification Points Expiry Last Chance enabled.
​

Points expiry notifications do not include an expiring-points amount.

Event property

Meaning and availability

time_until_expiry

Approximate time until expiry in hours or days, such as 3 days. This is display text, not an exact duration.

expiry_date

Expiry date in day-with-suffix format, such as 3rd Oct 2026.

expiry_date_formatted

Expiry date using your store’s configured date format and time zone.

Triggered at the expiry warning stage for credits. Requires credits expiry and Notification Credits Expiry Warning enabled.

Event property

Meaning and availability

expiry_amount

Credit amount covered by this expiry notification, with two decimal places. For an individual earning notification, this is that earning’s amount.

formatted_expiry_amount

The same credit amount in your store’s money format.

time_until_expiry

Approximate time until expiry in hours or days, such as 3 days. This is display text, not an exact duration.

expiry_date

Expiry date in day-with-suffix format, such as 3rd Oct 2026.

expiry_date_formatted

Expiry date using your store’s configured date format and time zone.

Triggered at the last-chance expiry reminder stage for credits. Requires credits expiry and Notification Credits Expiry Last Chance enabled.

Event property

Meaning and availability

expiry_amount

Credit amount covered by this expiry notification, with two decimal places. For an individual earning notification, this is that earning’s amount.

formatted_expiry_amount

The same credit amount in your store’s money format.

time_until_expiry

Approximate time until expiry in hours or days, such as 3 days. This is display text, not an exact duration.

expiry_date

Expiry date in day-with-suffix format, such as 3rd Oct 2026.

expiry_date_formatted

Expiry date using your store’s configured date format and time zone.

​

Triggered when a customer signs up as a referral advocate. Requires a recent advocate opt-in (within the past hour), no previous corresponding signup message, and Advocate Signup enabled. Sent to the advocate’s profile.

Event property

Meaning and availability

referral_link

The advocate’s shareable referral URL.

Triggered when a referral completes. Requires a qualifying referral and Referral Completed enabled. Sent to the advocate’s profile.

Event property

Meaning and availability

friend_email

Referred friend’s email; blank if unavailable.

referrals_completed

Total number of completed referrals for this advocate when the event is prepared.

Triggered when the referred friend claims the referral offer. Requires a referral offer and Friend Claim enabled. Sent to the friend’s profile.
​

Reward details come from the referral campaign’s friend reward, or the store’s friend reward for referrals without a campaign.

Event property

Meaning and availability

friend_email

Referred friend’s email.

reward_name

Reward name; blank if unavailable.

reward_code

Issued reward code; blank if unavailable.

reward_tos

Reward terms as text; blank if no terms apply or no reward is available.

Triggered when an advocate creates a referral invitation. Requires referral invitations and Invite Friend enabled. Sent to the advocate’s profile; friend_email is event data, not the profile receiving this event.

Event property

Meaning and availability

advocate_name

Advocate’s full name; blank if unavailable.

reward_name

Campaign’s friend reward name; blank if unavailable.

friend_email

Email address entered for the invited friend.

​

Triggered on first account activation. Requires Customer Account Activated enabled. Historical activations older than one day do not trigger this event.

Event property

Meaning and availability

account_activated_at

Customer’s account activation timestamp.

Triggered when a customer adds a product to favorites. Requires the favorites experience and Product Added To Favorites enabled.

Event property

Meaning and availability

product_id

Shopify product ID.

product_name

Product title; blank if unavailable.

product_url

Storefront product URL; blank if the product link is unavailable.

product_image_url

Product image URL; blank if unavailable.

Requires a membership program and the relevant membership action, plus the matching event enabled in Membership Events. A visible switch alone does not guarantee delivery: see Membership Payment Success below. Membership IDs in event properties are separate from the Klaviyo profile ID. Billing interval values are daily, weekly, monthly, quarterly, semi_annually, annually, or one_time.
​

Triggered when a customer is enrolled in a membership tier. Requires Membership Signup enabled.

Event property

Meaning and availability

signed_up_at

Membership start timestamp; may be blank.

customer_id

Shopify customer ID.

membership_tier_id

Rivo membership tier ID; may be blank.

membership_tier_name

Membership tier name; blank if unavailable.

membership_tier_price

Tier price as a number in store currency; may be blank.

membership_tier_billing_interval

Tier billing interval; may be blank.

Triggered when an immediate cancellation is requested. Requires a membership tier and Membership Canceled enabled. This event does not confirm that cancellation succeeded. End-of-period requests use Pending Cancellation instead.

Event property

Meaning and availability

cancelled_at

Membership end timestamp, or the current time if the end time is unavailable. Note the double “l” in this property name.

customer_id

Shopify customer ID.

Triggered when cancellation at the end of the billing period is requested. Requires a membership tier and Membership Pending Cancellation enabled. This event does not confirm that scheduling succeeded.

Event property

Meaning and availability

queued_for_cancellation_at

Scheduled membership end timestamp, rather than the time the customer requested cancellation; may be blank.

customer_id

Shopify customer ID.

Triggered when a recently completed membership billing attempt fails. Requires an active membership tier and Membership Payment Failure enabled. Attempts completed more than 14 hours ago do not generate a new failure event.
​

This event does not include payment failure details, an order ID, or a tier price.

Event property

Meaning and availability

membership_tier_name

Membership tier name; blank if unavailable.

attempt_number

Billing attempt number; can be blank if unavailable.

completed_at

Billing attempt completion timestamp; may be blank.

failure_at

Failure timestamp, matching completed_at; may be blank.

failed_at

Same failure time as failure_at; may be blank.

Availability: reference only. Although a Membership Payment Success switch exists, normal Klaviyo delivery does not currently send this metric. Use Rivo Membership Successful Rebill for successful billing events.
​

The properties below are listed for reference; this event is not sent automatically.

Event property

Meaning and availability

membership_tier_name

Membership tier name; blank if unavailable.

attempt_number

Billing attempt number; can be blank if unavailable.

completed_at

Billing attempt completion timestamp; may be blank.

succeeded_at

Success timestamp, matching completed_at; may be blank.

Triggered when a pre-renewal reminder is processed for an upcoming membership billing date. Requires configured warning or final reminder days, an active membership and subscription, and Membership Renewal Notice enabled. The next billing date must be between 12 hours and 60 days away. Queued cancellations, a cancellation request in the past 30 days, or a same-stage reminder in the past five days exclude a membership. Membership migration mode normally suppresses reminders. Both reminder stages use this metric, independently of the Rivo renewal email switch.

Event property

Meaning and availability

next_billing_date

Upcoming billing timestamp; may be blank.

membership_tier_name

Membership tier name; blank if unavailable.

renewal_date

Same billing date as next_billing_date; may be blank.

Triggered when a membership billing attempt succeeds. Requires an active membership tier and Membership Successful Rebill enabled. Attempts completed more than 14 hours ago do not generate a new event.

Event property

Meaning and availability

membership_tier_name

Membership tier name; blank if unavailable.

attempt_number

Billing attempt number; can be blank if unavailable.

completed_at

Billing attempt completion timestamp; may be blank.

billing_interval

Membership tier billing interval; may be blank.

next_billing_date

Next billing timestamp available when the event is prepared; may be blank.

Triggered when a membership is paused. Requires a membership that can be paused and Membership Paused enabled.

Event property

Meaning and availability

membership_tier_name

Membership tier name; blank if unavailable.

paused_at

Most recent subscription pause timestamp; may be blank.

Triggered when a membership billing cycle is skipped. Requires a skippable billing cycle and Membership Billing Skipped enabled.

Event property

Meaning and availability

membership_tier_name

Membership tier name; blank if unavailable.

skipped_at

Most recent billing-skip timestamp; may be blank.

new_billing_date

Next billing timestamp after the skip; may be blank.

​

Availability: reference only. This metric describes a processed loyalty gift, but normal Klaviyo delivery does not currently expose an event switch for it. Do not rely on it to trigger an automatic flow.
​

A setup sample may create this metric for accounts with loyalty gifts. This does not mean that live customer events will follow.

Event property

Meaning and availability

reward_name

Reward name; blank if unavailable.

reward_code

Issued reward code; blank if unavailable.

reward_tos

Reward terms as text; blank if no terms apply or no reward is available.

message

Gift message; can be blank or empty when no message is supplied.

Triggered when a virtual gift card is delivered to its recipient. Requires a recipient, a due delivery date, and Virtual Gift Card Delivery enabled. Imported gift cards do not generate this delivery event.

Event property

Meaning and availability

gift_card_code

Gift-card redemption code; can be blank if unavailable.

gift_card_expires_on

Expiry date as YYYY-MM-DD; blank for no expiry.

gift_card_initial_value

Original issued value as a number; not the remaining balance.

gift_card_note

Original gift note, or the current note if the original is blank; can be blank.

gift_card_recipient_first_name

Recipient’s first name; may be blank.

gift_card_recipient_full_name

Recipient’s full name; may be blank.

gift_card_sender_first_name

Sender’s first name; may be blank.

gift_card_sender_full_name

Sender’s full name; may be blank.

Availability: reference only. A Virtual Gift Card Reminder switch exists, but there is currently no automatic reminder delivery schedule for this metric. A setup sample can still create it in Klaviyo.
​

Enabling the switch does not schedule reminders.

Event property

Meaning and availability

gift_card_code

Gift-card redemption code; can be blank if unavailable.

gift_card_expires_on

Expiry date as YYYY-MM-DD; blank for no expiry.

gift_card_initial_value

Original issued value as a number; not the remaining balance.

gift_card_note

Original gift note, or the current note if the original is blank; can be blank.

gift_card_recipient_first_name

Recipient’s first name; may be blank.

gift_card_recipient_full_name

Recipient’s full name; may be blank.

gift_card_sender_first_name

Sender’s first name; may be blank.

gift_card_sender_full_name

Sender’s full name; may be blank.

Triggered when a bulk gift-card campaign delivers a card to a recipient. Requires a delivering bulk gift-card campaign and Bulk Gift Card Delivery enabled.

Event property

Meaning and availability

gift_card_amount

Original issued gift-card amount as a number.

gift_card_code

Gift-card redemption code; may be blank.

gift_card_bulk_campaign_id

Campaign identifier; can be blank if unavailable.

gift_card_bulk_campaign_name

Campaign name; may be blank.

gift_card_note

Original campaign gift note; may be blank.

gift_card_expiration_date

Optional: expiry date as YYYY-MM-DD; omitted if no expiry.

Requires Cashback available for your account, a qualifying offer/order with an associated cashback earning, and the matching switch under Cashback Events. See Cashback Offers for program setup. All three metrics include the seven shared fields below. The event name and status are separate: status is the opt-in’s current state when the event is prepared, so do not infer it solely from the metric name.
​

Triggered when a qualifying cashback opt-in moves into Holding while approval is delayed. Requires Cashback Earned Pending enabled. Merely capturing an opt-in does not send this event.
​

Pending events do not include claim_url, expiry_date, or expiry_date_formatted, even if claim-only approval or an expiry is configured.

Event property

Meaning and availability

trigger_name

Exact cashback event label: cashback_earned_pending, cashback_earned_completed, or cashback_earned_completed_reminder.

earnings_amount

Associated cashback earning’s credit amount as a decimal amount, not the customer’s remaining balance.

formatted_earnings_amount

The same amount in your store’s money format.

scheduled_approval_at

Scheduled approval timestamp; blank when no approval time is scheduled. Included on all three metrics.

cashback_offer_id

Rivo cashback offer ID.

order_id

Shopify order ID; can be blank if no order is available.

status

Current opt-in status: pending, holding, approved, or rejected.

Triggered when a qualifying cashback opt-in changes to Approved. Requires Cashback Earned Completed enabled. A claim-only invitation sent before approval does not itself trigger this event.
​

The claim link is included only with claim-only approval. Expiry details are included only when an expiry is configured. The scheduled approval date may be blank.

Event property

Meaning and availability

trigger_name

Exact cashback event label: cashback_earned_pending, cashback_earned_completed, or cashback_earned_completed_reminder.

earnings_amount

Associated cashback earning’s credit amount as a decimal amount, not the customer’s remaining balance.

formatted_earnings_amount

The same amount in your store’s money format.

scheduled_approval_at

Scheduled approval timestamp; blank when no approval time is scheduled. Included on all three metrics.

cashback_offer_id

Rivo cashback offer ID.

order_id

Shopify order ID; can be blank if no order is available.

status

Current opt-in status: pending, holding, approved, or rejected.

claim_url

Optional: included only when claim-only cashback approval is enabled. Customer link to claim approval.

expiry_date

Optional: included when the earning has an expiry, such as 3rd Oct 2026.

expiry_date_formatted

Optional: included alongside expiry_date, using your store’s date format and time zone.

Triggered for an Approved cashback opt-in last updated the configured number of reminder days ago (seven days by default). Requires a positive reminder-day setting and Cashback Earned Completed Reminder enabled. The Rivo reminder email switch can be off; the Klaviyo event is independent. A reminder already sent for that earning can suppress another send.
​

The reminder does not check for an unused balance. Its earnings_amount is the associated earning amount, not the amount left to spend. The same optional claim-link and expiry rules as Completed apply.

Event property

Meaning and availability

trigger_name

Exact cashback event label: cashback_earned_pending, cashback_earned_completed, or cashback_earned_completed_reminder.

earnings_amount

Associated cashback earning’s credit amount as a decimal amount, not the customer’s remaining balance.

formatted_earnings_amount

The same amount in your store’s money format.

scheduled_approval_at

Scheduled approval timestamp; blank when no approval time is scheduled. Included on all three metrics.

cashback_offer_id

Rivo cashback offer ID.

order_id

Shopify order ID; can be blank if no order is available.

status

Current opt-in status: pending, holding, approved, or rejected.

claim_url

Optional: included only when claim-only cashback approval is enabled. Customer link to claim approval.

expiry_date

Optional: included when the earning has an expiry, such as 3rd Oct 2026.

expiry_date_formatted

Optional: included alongside expiry_date, using your store’s date format and time zone.

​

Triggered when a customer-to-customer credit transfer completes. Requires credit transfers available for your store, completion notifications enabled for the transfer, and Earning Transfer Completed enabled. The switch is shown when credit transfers are available. Sent to the recipient’s profile.

Event property

Meaning and availability

credits_amount

Transferred credits as a number.

formatted_credits_amount

Transferred credits in your store’s money format.

sender_name

Sender’s full name; may be blank.

sender_email

Sender’s email; may be blank.

message

Transfer message; may be blank when not supplied.

completed_at

Transfer completion timestamp; may be blank.

​

When you save your connected Klaviyo integration settings, Rivo sends sample events using the test email [email protected]. These samples let expiry metrics appear in Klaviyo before a real customer qualifies for a reminder. If only the test profile appears, you may be seeing a setup sample.
​

Real customer events are sent when eligible points reach the warning or last-chance reminder stage, with points expiry and the matching Klaviyo event enabled. To preview real customer data, wait for a qualifying live event. Saving the integration settings or syncing customers does not replay past expiry events.
​

Rivo Notification Points Expiry Warning and Rivo Notification Points Expiry Last Chance include only the time until expiry and the expiry date in two formats. They do not include the number of points expiring or the customer’s current points balance.
​

Rivo Points Next Expiry Amount and Rivo Points Next Expiry Date are separate Klaviyo profile properties. They provide the amount expected to expire next and its date. Points expiry must be enabled, and these properties must also be enabled for your account. Ask your Rivo customer success manager to check availability and enablement.
​

These values update during customer profile sync. Use them as profile properties when personalizing an email, rather than as expiry-event properties. Receiving an expiry event does not guarantee that these profile values have refreshed. See Klaviyo integration for profile properties and customer sync instructions.