Skip to main content

Getting Started with Attentive Integration

Connect Mage Loyalty to your Attentive account so your loyalty data flows automatically into Attentive. Use it to build SMS and email journeys triggered by points, redemptions, tier changes, referrals, birthdays, and more.

Written by Kris James

What this integration does

Once connected, Mage Loyalty will:

  1. Push loyalty data onto each Attentive subscriber profile as custom attributes (points balance, VIP tier, lifetime points, etc.).

  2. 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

  1. In Mage Loyalty, go to Integrations, then click the Attentive card.

  2. Click Connect with Attentive.

  3. Sign in to your Attentive account when prompted.

  4. Review and accept the requested permissions.

  5. 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

Mage Points Balance

Points the customer can currently spend.

1500

Mage Lifetime Points

Total points the customer has ever earned.

5000

Mage Redeemed Points

Total points the customer has spent.

3500

Mage VIP Tier Name

The customer's current VIP tier.

Gold

Mage Enrolled Date

When the customer joined your loyalty program.

January 1, 2025

Mage Date of Birth

The customer's birthday (only if provided).

September 17, 1990

Mage Last Synced

When Mage last pushed an update to Attentive.

May 13, 2026 3:56 PM

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

Points Awarded

A customer earns points (purchase, action, signup, anniversary, and so on).

On

Points Pending

A customer earns points that are pending approval (for example, refund window).

Off

Reward Redeemed

A customer redeems points for a reward or discount.

On

VIP Tier Changed

A customer moves up or down a VIP tier.

On

Referral Invite Sent

An advocate sends a referral invite to a friend by email.

Off

Referral Claimed

A friend claims their referral discount code.

Off

Referral Reward Earned

An advocate earns their reward after the friend completes a qualifying purchase.

Off

Points Expiry Soon

A customer has points expiring within the next 7 days.

Off

Gift Reminder

A gift occasion reminder is due for a customer.

Off

Birthday

A customer earns points on their birthday.

Off

Wishlist events

Event name

When it fires

Default

Wishlist Reminder

An item has been in a customer's wishlist past the reminder delay.

Off

Wishlist Back in Stock

A wishlisted item is restocked.

Off

Wishlist Price Drop

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 the New Tier Name property 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].

Did this answer your question?