# Get started with Reactors

## What are reactors?

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:

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Trigger</strong></td><td>The event type that activates the reactor. This could be a purchase, referral, account creation, or any other event you define.</td><td><a href="/files/hbiTRdpLqbHlyCKbpTev">/files/hbiTRdpLqbHlyCKbpTev</a></td><td><a href="/pages/afmtlPY5SReqlvs8PqJR">/pages/afmtlPY5SReqlvs8PqJR</a></td></tr><tr><td><strong>Conditions</strong></td><td>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.</td><td><a href="/files/x7UJxIycUB7dOKyXzh7N">/files/x7UJxIycUB7dOKyXzh7N</a></td><td><a href="/pages/tSVRCcu5Ty7slQWR4RRS">/pages/tSVRCcu5Ty7slQWR4RRS</a></td></tr><tr><td><strong>Reactions</strong></td><td>What happens when a trigger fires and conditions are met – such as adjusting points, issuing a reward or calling a webhook.</td><td><a href="/files/o47jIo2yFpLFBkNjCKVL">/files/o47jIo2yFpLFBkNjCKVL</a></td><td><a href="/pages/ugl5lg0gLYbSo82LoVOn">/pages/ugl5lg0gLYbSo82LoVOn</a></td></tr></tbody></table>

### Event & reactor flow

<figure><img src="/files/UvDSFAwIP89wyaPUUMpe" alt="" width="563"><figcaption><p>Basic diagram of a reactor configuration</p></figcaption></figure>

***

## Reactor examples

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

<table data-card-size="large" data-view="cards"><thead><tr><th>Reactor</th><th>Trigger</th><th>Conditions</th><th>Reaction</th></tr></thead><tbody><tr><td><strong>Promotional sign-up bonus</strong></td><td>Intrinsic event type: <code>REGISTERED_ACCOUNT</code></td><td><ul><li>None</li></ul></td><td><ul><li>Adjust the user's points balance by <code>+500</code> points.</li></ul></td></tr><tr><td><strong>Core points earning</strong></td><td>Custom event type: <code>ORDER_PLACED</code></td><td><ul><li>None</li></ul></td><td><ul><li>Adjust the user's points balance by <code>+$totalSpend*1</code> points</li></ul></td></tr><tr><td><strong>Partner promo code bonus</strong></td><td>Custom event type: <code>SUBMITTED_CODE</code><br>Available with <a data-mention href="/pages/rTnNKAn0mNipNoAZEcMV">/pages/rTnNKAn0mNipNoAZEcMV</a> module.</td><td><ul><li>Code submitted is <code>FREE5</code></li><li>Activation limit: Only apply to first 100 members to enter code</li></ul></td><td><ul><li>Put £5 voucher in user's wallet</li><li>Call webhook to trigger thank you email</li></ul></td></tr><tr><td><strong>Earn double points this weekend when you buy a £10 voucher</strong></td><td>Custom event type: <code>ORDER_PLACED</code></td><td><ul><li>User in audience: voucher X purchased</li><li>Date is between: Fri 1 Feb and Sun 3 Feb</li></ul></td><td><ul><li>Adjust the user's points balance by <code>+$totalSpend*1</code> points (running concurrently with core points earning reactor means double points)</li></ul></td></tr><tr><td><strong>Social media mention bonus</strong></td><td>Custom event type: <code>MENTIONED_YOU_SOCIAL</code><br>Available with <a data-mention href="/pages/lSTbyUXfGfeA1BCFi2ht">/pages/lSTbyUXfGfeA1BCFi2ht</a> module.</td><td><ul><li>User in audience: Over 5000 followers</li></ul></td><td><ul><li>Adjust the user's points balance by <code>+2000</code> points.</li><li>Award Influencer badge.</li></ul></td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://kbase.whitelabel-loyalty.com/product/loyalty-engine/reactors/get-started-with-reactors.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.