Skip to main content

Omnisend Customer Properties & Events

Written by Kris - Mage Loyalty
Updated over 3 weeks ago

Events

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


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


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

  1. In Omnisend, go to Automation > New Workflow

  2. Set the trigger to Custom Event > Points Expiry Soon

  3. Add an Email or SMS action with your expiry reminder template

  4. 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!


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

Did this answer your question?