Events

Each event can be toggled on/off per-shop in Settings > Integrations > Omnisend.

Points Awarded

Fired when a customer earns points through purchases, actions, or other earning rules.

Contact: Customer's email

Property	Type	Description
`Points Awarded`	number	Number of points earned
`Earning Rule`	string	Name of the earning rule (or "Manual")
`Status`	string	Status of the earning (e.g. `approved`)
`Order Number`	string (optional)	Shopify order number, if points were earned from a purchase

Points Pending

Fired when a customer earns points that are not yet in their balance because the earning rule has a waiting period (e.g. purchase points held until the refund window closes). When the approval cron later awards these points, a separate Points Awarded event will fire.

This event is OFF by default. Merchants must enable it in Settings > Integrations > Omnisend before it will fire.

Contact: Customer's email

Property	Type	Description
`Points Awarded`	number	Number of points that will be awarded once approved
`Earning Rule`	string	Name of the earning rule (or "Manual")
`Status`	string	Always `PENDING`
`Order Number`	string (optional)	Shopify order number, if points were earned from a purchase

Bonus Points Awarded

Flat bonus points from a tiered bonus campaign.

This event is OFF by default. Merchants must enable it in Settings > Integrations > Omnisend before it will fire.

Contact: Customer's email

Property	Type	Description
`Bonus Points`	number	Number of bonus points awarded
`Campaign Name`	string	Name of the bonus campaign
`Qualifying Spend`	number	The order amount that qualified for the bonus
`Spend Threshold`	number	The spend threshold that was met
`Status`	string	`APPROVED` or `PENDING`
`Order Number`	string (optional)	Shopify order number, if the bonus came from a purchase

Reward Redeemed

Fired when a customer redeems their points for a reward or discount.

Contact: Customer's email

Property	Type	Description
`Reward Name`	string	Name of the reward redeemed
`Points Spent`	number	Number of points spent (0 if null)
`Discount Type`	string	Type of discount (e.g. `percentage`, `fixed`)

VIP Tier Changed

Fired when a customer moves up or down VIP tiers based on their lifetime points.

Contact: Customer's email

Property	Type	Description
`New Tier Name`	string	Name of the tier the customer moved to
`Previous Tier Name`	string (optional)	Name of the previous tier, if applicable

Referral Invite Sent

Fired when an advocate sends a referral email invite to a friend.

This event is OFF by default. Merchants must enable it in Settings > Integrations > Omnisend before it will fire.

Contact: Advocate's email

Property	Type	Description
`Recipient Email`	string	Email address of the invited friend
`Campaign Name`	string	Name of the referral campaign
`Advocate Name`	string	Name of the advocate (or "A friend" if not provided)
`Subject`	string	Email subject line used for the invite
`Personal Message`	string	Custom message written by the advocate
`Referral URL`	string	The referral link sent to the friend
`Shop Name`	string	Name of the Shopify store
`Shop Domain`	string	Domain of the Shopify store
`Channel`	string	Always `email`

Referral Claimed

Fired when a friend claims their referral discount code.

This event is OFF by default. Merchants must enable it in Settings > Integrations > Omnisend before it will fire.

Contact: Friend's email

Property	Type	Description
`Discount Code`	string	The discount code generated for the friend
`Discount Type`	string	Type of discount (`percentage`, `fixed`, `free-shipping`, `free-product`)
`Discount Amount`	number	Discount value (0 if null)
`Campaign Name`	string	Name of the referral campaign
`Reward Name`	string	The merchant-defined reward name as set in the campaign reward settings
`Advocate Email`	string (optional)	Email of the advocate who referred the friend, if known
`Advocate Name`	string (optional)	Name of the advocate, if known
`Shop Name`	string	Name of the Shopify store
`Shop Domain`	string	Domain of the Shopify store

Referral Reward Earned

Fired when an advocate earns their reward after their referred friend completes a purchase.

This event is OFF by default. Merchants must enable it in Settings > Integrations > Omnisend before it will fire.

Contact: Advocate's email

Property	Type	Description
`Friend Email`	string	Email of the friend whose purchase triggered the reward
`Discount Code`	string	The advocate's reward discount code
`Discount Type`	string	Type of discount (`percentage`, `fixed`, `free-shipping`, `free-product`)
`Discount Amount`	number	Discount value (0 if null)
`Reward Name`	string	The merchant-defined reward name as set in the campaign reward settings
`Campaign Name`	string	Name of the referral campaign
`Shop Name`	string	Name of the Shopify store
`Shop Domain`	string	Domain of the Shopify store

Points Expiry Soon

Fired when a customer has loyalty points expiring within the next 7 days. This event is triggered once per customer per 7-day window — multiple earning rules expiring on different days are aggregated into a single event to prevent duplicate notifications.

This event is OFF by default. Merchants must enable it in Settings > Integrations > Omnisend before it will fire.

Contact: Customer's email

Property	Type	Description
`Points Expiring`	number	Total points expiring within the next 7 days (aggregated across all earning rules)
`Current Points`	number	Customer's current point balance at the time the event fires
`Days Until Expiry`	number	Days until the earliest expiring points (e.g. `3` means points expire in 3 days)
`Customer Name`	string	Customer's first name (or "there" if not set)

Suggested automation setup

In Omnisend, go to Automation > New Workflow
Set the trigger to Custom Event > Points Expiry Soon
Add an Email or SMS action with your expiry reminder template
Use the event properties above as dynamic variables in your template:
- {{Points Expiring}} — the number of points about to expire
- {{Current Points}} — the customer's total balance
- {{Days Until Expiry}} — urgency indicator for the subject line or body
- {{Customer Name}} — personalization

Example subject line

{{ Customer Name }}, your {{ Points Expiring }} points expire in {{ Days Until Expiry }} days!

Gift Reminder

Each reminder includes a unique discount code, created on the first reminder and reused on follow-ups.

This event is OFF by default. Merchants must enable it in Settings > Integrations > Omnisend before it will fire.

Contact: Customer's email

Property	Type	Description
`Recipient Name`	string	Name of the gift recipient (e.g. "Mom")
`Relationship`	string	How they're related (e.g. "Mother", "Friend")
`Occasion Type`	string	`birthday`, `anniversary`, or `other`
`Occasion Date`	string	Date in MM/DD format (e.g. "03/15")
`Occasion Month`	number	Month as a number (1-12)
`Occasion Day`	number	Day as a number (1-31)
`Days Until Occasion`	number	How many days until the occasion (matches the reminder interval)
`Reminder Number`	number	Which reminder this is (1, 2, or 3) based on the configured order
`Discount Code`	string	Unique discount code for this recipient
`Customer Name`	string	Customer's first name (or "there" if not set)
`Shop Domain`	string	The store's public domain

Birthday

Fired when a customer earns birthday points. Includes the points earned and updated balance so merchants can build birthday automations with reward information.

This event is OFF by default. Merchants must enable it in Settings > Integrations > Omnisend before it will fire.

Contact: Customer's email

Property	Type	Description
`Customer Name`	string	Customer's first name (or "Valued Customer" if not set)
`Shop Name`	string	Name of the Shopify store
`Points Earned`	number	Number of birthday points awarded today
`Current Points`	number	Customer's updated total point balance after the award

Wishlist Reminder

A reminder to a customer about items still on their wishlist. Omnisend supports arrays and nested objects, so you can reference the full Items list in your automation.

This event is OFF by default. Merchants must enable it in Settings > Integrations > Omnisend before it will fire. Wishlist alert provider on the shop must also be set to Omnisend.

Contact: Customer's email

Property	Type	Description
`Customer Name`	string	Customer's first name (or "there" if not set)
`Shop Name`	string	Name of the Shopify store
`Shop Domain`	string	The store's public domain
`Items Count`	number	Number of items in this reminder
`Items`	array	Array of item objects (shape below)

Items element shape

Field	Type	Description
`ProductId`	string	Shopify product ID
`ProductName`	string \| null	Display name of the product
`ProductPrice`	number \| null	Current price
`ProductQuantity`	number \| null	Current stock quantity
`ProductBrand`	string \| null	Product brand
`ProductCategory`	string \| null	Product category
`VariantId`	string \| null	Shopify variant ID
`VariantInfo`	string \| null	Variant title (e.g. "Oat / Medium")
`VariantSKU`	string \| null	Variant SKU
`ProductURL`	string \| null	Public product URL
`ImageURL`	string \| null	Product image URL
`ProductTagsList`	string[]	Product tags as an array
`ProductTags`	string	Product tags as a comma-separated string
`AddedAt`	string	ISO timestamp when the item was added to the wishlist

Wishlist Back in Stock

Same shape as Wishlist Reminder. Omnisend supports arrays and nested objects, so you can reference the full Items list in your automation.

This event is OFF by default. Merchants must enable it in Settings > Integrations > Omnisend before it will fire. Wishlist alert provider on the shop must also be set to Omnisend.

Contact: Customer's email

Property	Type	Description
`Customer Name`	string	Customer's first name (or "there" if not set)
`Shop Name`	string	Name of the Shopify store
`Shop Domain`	string	The store's public domain
`Items Count`	number	Number of items now back in stock
`Items`	array	Array of item objects (same shape as Wishlist Reminder)

Wishlist Price Drop

Fired when items on a customer's wishlist drop in price. Omnisend supports arrays and nested objects, so you can reference the full Items list in your automation.

This event is OFF by default. Merchants must enable it in Settings > Integrations > Omnisend before it will fire. Wishlist alert provider on the shop must also be set to Omnisend.

Contact: Customer's email

Property	Type	Description
`Customer Name`	string	Customer's first name (or "there" if not set)
`Shop Name`	string	Name of the Shopify store
`Shop Domain`	string	The store's public domain
`Items Count`	number	Number of items in this event (the items shown in this notification)
`Total Items On Sale`	number	Total wishlisted items currently on sale (broader count for CTA copy)
`Additional Items Count`	number	Total Items On Sale minus Items Count. The "X others" number for subject copy
`Items`	array	Array of item objects (shape below)

Items element shape

Same fields as the Wishlist Reminder items, plus four price-drop-specific fields:

Field	Type	Description
`OldPrice`	number	Price before the drop
`NewPrice`	number	Price after the drop
`DropPercent`	number	Percentage drop (e.g. `20` for 20% off)
`CompareAtPrice`	number \| null	Shopify compareAtPrice, if set

Mage Welcome

Fired once when a new customer first joins the loyalty program.

This event is OFF by default. Merchants must enable it in Settings > Integrations > Omnisend before it will fire.

Contact: Customer's email

Property	Type	Description
`Current Points`	number	Customer's current point balance

Cashback Credited

Store-credit cashback awarded.

This event is OFF by default. Merchants must enable it in Settings > Integrations > Omnisend before it will fire.

Contact: Customer's email

Property	Type	Description
`Cashback Amount`	number	Cashback value awarded
`Cashback Amount Formatted`	string	Cashback value formatted for display (e.g. "$5.50")
`Currency`	string	Currency code for the cashback amount
`Offer Name`	string	Name of the cashback offer
`Order Number`	string	Shopify order number the cashback relates to
`Reward Method`	string	Always `shopify_store_credit`
`Expires At`	string (optional)	ISO timestamp when the cashback expires, if applicable

Cashback Code Issued

Cashback issued as a single-use discount code (incl. reissue after a partial refund).

This event is OFF by default. Merchants must enable it in Settings > Integrations > Omnisend before it will fire.

Contact: Customer's email

Property	Type	Description
`Cashback Amount`	number	Cashback value issued
`Cashback Amount Formatted`	string	Cashback value formatted for display (e.g. "$5.50")
`Currency`	string	Currency code for the cashback amount
`Offer Name`	string	Name of the cashback offer
`Order Number`	string	Shopify order number the cashback relates to
`Reward Method`	string	Always `discount_code`
`Discount Code`	string	The single-use cashback discount code
`Expires At`	string (optional)	ISO timestamp when the cashback expires, if applicable

Contact Properties

In addition to events, Mage syncs the following properties to each Omnisend contact. These can be used in segments, conditional splits, and personalization across any workflow or campaign.

Property	Example Value	Description
`Mage Loyalty Points Balance`	`100`	Customer's current spendable points
`Mage Loyalty Lifetime Points`	`500`	Total points ever earned
`Mage Loyalty Redeemed Points`	`400`	Total points spent on rewards
`Mage Loyalty VIP Tier Name`	`Gold`	Current VIP tier (e.g. Bronze, Silver, Gold)
`Mage Loyalty Date of Birth`	`September 17, 1990`	Customer's date of birth, if provided
`Mage Loyalty Enrolled Date`	`January 1, 2025`	When the customer joined the loyalty program
`Mage Loyalty Points as Cash Balance`	`$17.50`	Cash value of the current points balance, based on your flexible reward's conversion rate. Only synced when an active flexible reward exists.

Omnisend Customer Properties & Events

Events

Points Awarded

Points Pending

Bonus Points Awarded

Reward Redeemed

VIP Tier Changed

Referral Invite Sent

Referral Claimed

Referral Reward Earned

Points Expiry Soon

Suggested automation setup

Example subject line

Gift Reminder

Birthday

Wishlist Reminder

Items element shape

Wishlist Back in Stock

Wishlist Price Drop

Items element shape

Mage Welcome

Cashback Credited

Cashback Code Issued

Contact Properties