# Automated notifications

{% hint style="info" %}
This feature is available for **All** plans
{% endhint %}

### Understanding the Rules <a href="#understanding-the-rules" id="understanding-the-rules"></a>

The **Notifications** feature allows you to **automatically** send emails to customers whenever their **reward points change**—whether they **earn** or **redeem** points. This eliminates the need for **manual notifications**.

Available Notifications:

* Reward Programs: Birthday rewards, Earn points, POS point redemption, Redeem points
* Referral Programs: Coupons for referrers, Points for referrers, Referrals for friends
* VIP Tier: Notification when a customer reaches VIP status
* Points Expiry (Coming soon): Pre-notifications and last-call reminders for expiring points
* Send these emails through the default Joy app email sender, a custom sender address, or configure your own custom SMTP for full control over email delivery

<figure><img src="/files/nid6Khhvklb6cg2e0BdC" alt=""><figcaption></figcaption></figure>

### Toggling notifications <a href="#how-to-enable-notifications" id="how-to-enable-notifications"></a>

By default, notifications are disabled. There are two levels of notification settings:

**Global Enable/Disable:**

* You can **enable or disable** all notifications at once.
* If the **global setting** is disabled, **no notification emails** will be sent, even if individual program notifications are turned on.
* **To enable:**
  1. Go to the **Notifications** section in the **Joy app**.
  2. Switch on the **global toggle**.

**Individual Program Notifications:**

* Once notifications are **globally enabled**, you can customize them for **specific programs**.
* **To enable/disable individual program notifications:**
  1. Navigate to the **specific program** (e.g., Earn Points, Birthday Rewards).
  2. Toggle notifications **on or off** based on your preference.

<figure><img src="/files/LaYnbjuK1FOm6Z1DSgAt" alt=""><figcaption></figcaption></figure>

### Customize the notification email template <a href="#configure-notifications-for-earn-points" id="configure-notifications-for-earn-points"></a>

{% stepper %}
{% step %}
**Go to the Notifications section** in the **Joy app**
{% endstep %}

{% step %}
Locate the **Earn Points Program**
{% endstep %}

{% step %}
Click the **Edit** icon next to the email template
{% endstep %}

{% step %}
Modify the **email content, subject line, and design** as needed
{% endstep %}

{% step %}
Click **Save** to apply your changes

<figure><img src="/files/VFQiW5jH704Tw7aD1yhY" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Customizing the Email Notification Template

When customizing your email, you can edit the following fields:\
✔ **Subject** – The email’s subject line.\
✔ **Content** – The main message body.\
✔ **Action Text** – Call-to-action (e.g., "Claim Your Points").\
✔ **Logo** – Upload your store’s logo for branding.

**Available Variables:**

These variables dynamically insert customer or store information:

* **{{shop\_name}}** – Your store’s name
* **{{earning\_points}}** – Number of points the customer earned
* **{{earning\_program}}** – Name of the rewards program
* **{{customer\_name}}** – Customer’s name
* **{{customer\_email}}** – Customer’s email

**Preview & Testing:**

* Use the **Preview** feature to check the email content.
* To test the email before sending it to customers:
  1. Click **Send test**.
  2. Enter an **email address**.
  3. Click **Send**.
  4. Review the **test email sample** to ensure accuracy.

<figure><img src="/files/1gWXUZ7SGRYuM0QHbrTs" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### Advanced Customization: Using HTML for Email Templates

For merchants who need **more advanced customization**, you can **paste your HTML email template** directly into the content section.

**Steps for Using an HTML Email Template:**

{% stepper %}
{% step %}
**Paste your HTML code** into the content section.
{% endstep %}

{% step %}
When prompted, select **"Keep"** to ensure proper formatting
{% endstep %}
{% endstepper %}

### Manage sent emails

Once notifications are **enabled**, you can **monitor and manage** all sent emails through:

* Go to **Notifications > Manage Notifications**

**Key Features:**

* **Search Emails** – Find specific emails by entering the **customer’s full email address**.
* **Filter by Status** – Track email performance using these status filters:
  * **Sent** ✅ – Successfully delivered.
  * **Clicked** 🖱️ – The customer clicked a link inside the email.
  * **Opened** 📩 – The customer opened the email.
  * **Failed** ❌ – The email was not delivered (e.g., invalid email address).

This helps you **analyze performance** and quickly **resolve failed deliveries**.


---

# 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://help.joy.so/membership/vip-tiers/automated-notifications.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.