What this integration does
Once connected, Mage Loyalty will:
Push loyalty data onto each Attentive subscriber profile as custom attributes (points balance, VIP tier, lifetime points, etc.).
Fire custom events to Attentive whenever something happens in your loyalty program (a customer earns points, redeems a reward, changes tier, gets a referral reward, and so on).
You can then use those attributes and events inside Attentive's Segment Builder and Journey Builder to send the right SMS or email at the right moment.
Connect Attentive
In Mage Loyalty, go to Integrations, then click the Attentive card.
Click Connect with Attentive.
Sign in to your Attentive account when prompted.
Review and accept the requested permissions.
You will be redirected back to Mage Loyalty automatically. The card now shows Connected with your Attentive company name.
Registering event types
Attentive only shows custom event types inside its Journey and Segment Builders after the event has been fired at least once.
For each event you'd like to fire in Attentive, please enter your email and click Send test event. This automatically registers the event in Attentive.
Customer properties synced
These properties are written to each Attentive subscriber whose email matches a Mage Loyalty customer.
Property name | What it contains | Example |
| Points the customer can currently spend. |
|
| Total points the customer has ever earned. |
|
| Total points the customer has spent. |
|
| The customer's current VIP tier. |
|
| When the customer joined your loyalty program. |
|
| The customer's birthday (only if provided). |
|
| When Mage last pushed an update to Attentive. |
|
Use these in Attentive segments. For example, "Mage VIP Tier Name is Gold" or "Mage Points Balance is greater than 500".
Events fired
Each event below can be turned on or off independently from the Event Settings card on the integration page.
Loyalty events
Event name | When it fires | Default |
| A customer earns points (purchase, action, signup, anniversary, and so on). | On |
| A customer earns points that are pending approval (for example, refund window). | Off |
| A customer redeems points for a reward or discount. | On |
| A customer moves up or down a VIP tier. | On |
| An advocate sends a referral invite to a friend by email. | Off |
| A friend claims their referral discount code. | Off |
| An advocate earns their reward after the friend completes a qualifying purchase. | Off |
| A customer has points expiring within the next 7 days. | Off |
| A gift occasion reminder is due for a customer. | Off |
| A customer earns points on their birthday. | Off |
Wishlist events
Event name | When it fires | Default |
| An item has been in a customer's wishlist past the reminder delay. | Off |
| A wishlisted item is restocked. | Off |
| A wishlisted item drops in price below your configured threshold. | Off |
A note on wishlist event content
Wishlist Reminder and Wishlist Back in Stock are email-first. They include the full list of wishlisted items, which is great for emails that render a product carousel. SMS journeys cannot iterate over lists, so for SMS you can still personalise on customer name, shop name, and item count.
Wishlist Price Drop is the exception. In addition to the list, it also sends flattened fields for the lead product (name, image, old price, new price), so you can write SMS copy like "Was $68, now $54. Shop the drop." without needing a list.
Manage which events fire
On the integration page, the Event Settings card lets you toggle each event on or off. Changes save automatically.
Use the Loyalty and Wishlist tabs to switch between event groups. Default settings cover the most common use case (you start with the four loyalty events most merchants care about turned on).
Send a test event
Use the Send Test Event card to fire any of the 13 event types against an email of your choice with sample data. Useful for previewing payloads while building Attentive journeys.
You can preview the exact payload in the card before sending. The recipient does not need to be an existing Attentive subscriber for the event to be accepted.
Sync all customers
Click Sync All Customers at the top of the integration page to push every loyalty customer's properties to Attentive in one batch. Useful right after connecting, or if you suspect data has drifted.
Mage Loyalty also syncs automatically whenever a customer's points, tier, or other loyalty data changes, so you may only need to do this on initial integration but it is not mandatory.
Using your data in Attentive
A few examples of what you can build once the integration is running.
Segments
Gold tier customers:
Mage VIP Tier Name is Gold. Send them an exclusive offer.Big spenders ready to redeem:
Mage Points Balance is greater than 1000. Nudge them to spend.Loyalty program alumni:
Mage Enrolled Date is more than 365 days ago. Win-back flow.
Journeys
Points earned welcome: Trigger on
Points Awarded. Send an SMS congratulating the customer.Reward reminder: Trigger on
Reward Redeemed. Send a thank-you and recommend related products.Tier upgrade celebration: Trigger on
VIP Tier Changed. Use theNew Tier Nameproperty in the message body.Birthday journey: Trigger on
Birthday. Send a personalised wish with the bonus points they just earned.
Disconnect
To remove the integration, go to the Attentive integration page and click Disconnect. Mage Loyalty will stop sending data immediately. Your existing Attentive subscribers and the loyalty data already stored on their profiles are not deleted.
Troubleshooting
"Not Connected" badge after authorising
The OAuth flow did not complete cleanly. Re-click Connect with Attentive and authorise again. If the page reports a specific error, the most common causes are: permissions were denied during the authorisation screen, or the session expired before you finished. Both are fixed by retrying.
Customer attributes do not appear in Attentive
Custom attributes are only visible on the profile of an opted-in Attentive subscriber. If the customer's email is not yet an Attentive subscriber, Mage Loyalty stores the data for them but Attentive will not show it in the Subscribers UI until they opt in (through a sign-up form, popup, or programmatic opt-in).
Once they become a subscriber, their existing loyalty attributes appear on the profile automatically.
Custom events do not appear in the Journey Builder dropdown
Attentive only lists event types that have been fired at least once. Click Register all event types on the integration page to fire all 13 in one go. They will appear in the dropdowns within about 30 seconds.
Event was fired but not visible on the subscriber's Activity tab
Activity timelines only show events for actual subscribers. The event was accepted and stored, but Attentive will not display it on a customer's timeline until they become an opted-in subscriber. The event will appear retroactively once they do.
If you need help, email [email protected].
