Get started with Reactors

Learn how to use reactors to automate loyalty logic in response to user actions. Covers triggers, conditions, and reactions with practical examples and implementation tips.

How reactors work

Reactors are a core component of the Loyalty Engine. They automate what happens when a customer performs a specific action—like making a purchase, referring a friend, or reaching a milestone.

Each reactor is made up of three key parts:

Trigger

The event type that activates the reactor. This could be a purchase, referral, account creation, or any other event you define.

Conditions

Logic that decides whether the reactor should respond to the event – such as if a specific product was purchased, or if the user is in a particular audience.

Reactions

What happens when a trigger fires and conditions are met – such as adjusting points, issuing a reward or calling a webhook.

Event & reactor flow

Basic diagram of a reactor configuration

---

Reactor examples

Let's have a look at some reactor examples below.

Reactor

Promotional sign-up bonus

Trigger

Intrinsic event type: REGISTERED_ACCOUNT

Conditions

• None

Reaction

• Adjust the user's points balance by +500 points.

Reactor

Core points earning

Trigger

Custom event type: ORDER_PLACED

Conditions

• None

Reaction

• Adjust the user's points balance by +$totalSpend*1 points

Reactor

Partner promo code bonus

Trigger

Custom event type: SUBMITTED_CODE Available with Promo Codes module.

Conditions

• Code submitted is FREE5

• Activation limit: Only apply to first 100 members to enter code

Reaction

• Put £5 voucher in user's wallet

• Call webhook to trigger thank you email

Reactor

Earn double points this weekend when you buy a £10 voucher

Trigger

Custom event type: ORDER_PLACED

Conditions

• User in audience: voucher X purchased

• Date is between: Fri 1 Feb and Sun 3 Feb

Reaction

• Adjust the user's points balance by +$totalSpend*1 points (running concurrently with core points earning reactor means double points)

Reactor

Social media mention bonus

Trigger

Custom event type: MENTIONED_YOU_SOCIAL Available with Social Media module.

Conditions

• User in audience: Over 5000 followers

Reaction

• Adjust the user's points balance by +2000 points.

• Award Influencer badge.