What does the integration do?
The Omnisend integration syncs your Mage Loyalty program data to your Omnisend contacts and sends loyalty events to Omnisend. This allows you to:
View loyalty data on contacts - See points balances, VIP tiers and more directly in Omnisend
Create targeted segments - Build segments based on loyalty data like "Customers with 100+ points" or "Gold tier members"
Build automations - Trigger emails and SMS when customers earn points, redeem rewards or change VIP tiers
Personalize campaigns - Use loyalty data in your messages to make them more relevant
Customer data is matched by email address. Mage only writes its own Mage properties to your contacts.
The Omnisend integration is available on the Essential plan and above.
How to connect Mage Loyalty with Omnisend
Connecting Omnisend takes a few minutes and uses an Omnisend API key:
In Omnisend, go to Store Settings → API
Create an API key with access to Contacts and Events, or copy an existing one
In Mage Loyalty, navigate to Integrations → Omnisend
Paste the key into the Omnisend API Key field
Click Save API Key
Mage checks the key with Omnisend before saving it. If you see "Omnisend rejected this API key", check that you copied the full key and that it has access to Contacts and Events.
That's it! Each customer's loyalty data syncs to Omnisend whenever their points, tier or rewards change. To stop syncing, click Disconnect on the Omnisend integration page.
What customer data is synced to Omnisend
The following loyalty properties are synced to your Omnisend contacts:
Property Name | Description | Example Value |
Mage Points Balance | Current available points | 100 |
Mage Lifetime Points | Total points earned all-time | 500 |
Mage Redeemed Points | Total points redeemed | 400 |
Mage Vip Tier Name | Current VIP tier | Bronze, Silver, Gold |
Mage Next Vip Tier Name | The next VIP tier the customer has not reached yet | Platinum |
Mage Amount To Next Vip Tier | How much more the customer needs to reach that tier | 380 |
Mage Points As Cash Balance | Cash value of the customer's current points balance (flexible redemption must be enabled) | $17.50 |
Mage Date Of Birth | Customer's birthday (if provided) | 1990-09-17 |
Mage Enrolled Date | When the customer joined the program | 2025-01-01 |
If your program runs on store credit instead of points, the balance properties are replaced by store credit ones. For the full list, including store credit and Growth plan properties, see Omnisend Customer Properties & Events.
Using loyalty data in Omnisend
Once synced, you can use these properties to:
Create segments: Target customers based on points balance, tier or enrollment date
Personalize messages: Include loyalty data like
[[contact.custom_properties.magePointsBalance]]in your campaigns and automationsBuild conditional splits: Send different messages based on VIP tier or points balance
What events are fired and how to toggle them
The integration can send the following loyalty events to Omnisend, which you can use to trigger automations:
Event Name | When It Fires |
Points Awarded | When points are added to a customer's balance, either immediately or after the approval waiting period has passed. |
Points Pending | When a customer earns points that are held during an approval waiting period (e.g. purchases waiting for the refund window to close). Off by default. |
Bonus Points Awarded | When a tiered bonus campaign awards flat bonus points. Off by default. |
Reward Redeemed | When a customer redeems their points for a reward or discount. |
VIP Tier Changed | When a customer moves up or down a VIP tier. |
Referral Invite Sent | When an advocate sends a referral email invite to a friend. Off by default. |
Referral Claimed | When a friend claims their referral discount code. Off by default. |
Referral Reward Earned | When an advocate earns their reward after their referred friend completes a purchase. Off by default. |
Points Expiry Soon | When a customer has loyalty points expiring within the next 7 days. Off by default. |
Gift Reminder | When a customer's gift recipient has an upcoming occasion matching one of the configured reminder intervals. Off by default. |
Birthday | When a customer earns birthday points on their birthday. Off by default. |
Mage Welcome | When a customer creates an account, or a guest becomes a registered customer. Off by default. |
Cashback Credited | When a customer earns cashback that is paid out as store credit. Off by default. |
Photo Challenge Approved | When you approve a photo challenge submission. Off by default. |
Photo Challenge Rejected | When you reject a photo challenge submission. Off by default. |
If your program runs on store credit, Points Awarded, Points Pending and Points Expiry Soon are sent as Store Credit Awarded, Store Credit Pending and Store Credit Expiry Soon. The properties on each event are listed in Omnisend Customer Properties & Events.
Managing event settings
You can toggle which events are sent to Omnisend at any time:
Navigate to Integrations → Omnisend in Mage Loyalty
Scroll to the Event Settings section (visible when connected)
Use the checkboxes to enable or disable each event type
Changes are saved automatically
Note: Disabled events are not sent to Omnisend, so only enable the events you plan to use in your automations.
Sending a test event
Once connected, use the Send Test Event section on the Omnisend integration page to send any event with sample data to an email address of your choice. Omnisend only lists an event as an automation trigger after it has been received once, so sending a test event lets you start building before real events come in.
FAQ
Why don't some contacts have Mage properties yet?
Mage sends a customer's properties the next time their points, tier or rewards change. Customers with no loyalty activity since you connected Omnisend will not have them yet.
Why was my API key rejected?
Omnisend did not accept the key. Make sure you copied the whole key from Store Settings → API, and that the key has access to Contacts and Events.
Need Help?
If you have questions about the Omnisend integration or need assistance setting up automations, contact our support team.