> For the complete documentation index, see [llms.txt](https://docs.perkville.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.perkville.com/features/emails.md).

# Emails

Perkville automates email notifications to support your loyalty and referral program, keeping customers engaged and your business informed. These emails help drive program participation, encourage referrals, and ensure customers stay aware of their rewards and progress.

## **How Perkville Sends Emails**

Emails will be sent on behalf of your business but will come from a Perkville domain (e.g., `rewards@perkville.com`) unless you configure a **custom branded domain**, such as `rewards@yourbusinessdomain.com`.

### Reply-to Address

The reply-to address can be configured in the **Business Info** section of your settings. We recommend setting it to an email address for your business or support team to ensure customers can reach you directly if they respond to an email.

## Customization

You are able to update the appearance of your emails via your program's branding settings. You can also update your welcome message (included in invitation emails) and Custom Notice (displays a custom button on your emails) via your program's advanced settings.

## Welcome messages in program invitations

The **welcome message** is optional, business-written text that appears in the invitation email inviting an eligible customer to join your Perkville rewards program. It is not the same as a points-earned email or a separate welcome email sent after every login.

You can edit it in **Settings → Advanced**, under the welcome-message setting. It is particularly useful for briefly introducing the program's benefits and explaining why the customer should join.

**Example:**

> Welcome to our rewards program! Earn points for eligible visits and other activities, then redeem them for rewards. Join using the invitation link in this email to get started.

Keep the text short, relevant to your program, and consistent with any membership or earning restrictions. For invitation types and email preferences, see [Program Invitations and Registration](#program-invitations-and-registration).

## Managing Email Preferences

Your customers can update their own email preferences at any time. Every Perkville email includes a link to manage settings or unsubscribe. Learn more about managing email preferences here.

Staff notification delivery depends on both the staff member's **role permissions** and that person's own **Business notifications** preferences. Location-restricted staff only receive applicable business notifications for locations they can access.

See [How do I control my email notifications?](https://docs.perkville.com/faqs/miscellaneous/how-do-i-control-my-email-notifications.md) and [Staff members](https://docs.perkville.com/features/settings/staff-members.md#staff-email-notifications).

## Toggling Activity Emails

You can decide which earning activities trigger an email notification from your program's reward program settings. For example, you can choose whether or not to send an email when customers earn points on their birthday.

## Emails Sent by Perkville

### Program Invitations and Registration

Encourage customers to join your loyalty program with automated invitation emails, making it easy for them to sign up and start earning rewards.

* **Welcome Invite:** Sent to a customer after they complete their first earning event, prompting them to join your loyalty program.
* **General Registration Invite:** Sent to customers who sign up for Perkville directly on our website.
* **Staff Invite:** Sent to customers that have been invited to join a business' loyalty program by a staff member.

### Point Earning Notifications

Keep customers engaged by notifying them when they earn points through check-ins, purchases, and other activities that earn points.

* **Points Earned Alert:** Sent when a customer who joined your loyalty program earns points.
* **Weekly Points Summary:** Sent to a customer summarizing their point activity over the past week.

### Redemption Notifications

Notify customers when they redeem a reward.

* **Reward Redemption Confirmation:** Sent to a customer after they redeem a reward.
* **Voucher Expiration Reminder:** Sent to a customer alerting them that they have unused vouchers that will expire soon.

### **Referral Emails**

When a customer refers a friend, if you have the **Share offer and enter friend's information layout,** then the customer can enter their friend's email into Perkville and Perkville will send an email to the friend on the customer's behalf, prompting the friend to claim an offer from your business.

* **Referral Invite Without Offer:** Sent when a customer refers a friend but no referral offer is set up.
* **Referral Invite With Offer:** Sent when a customer refers a friend and an active referral offer is available.
* **Offer Claimed:** Sent to a referred prospect after they claim a referral offer at your business.

Perkville does **not** send an automated reminder cadence to referral prospects who have not claimed or completed a referral. Businesses that want ongoing follow-up can use supported CRM integrations, where prospect follow-up workflows or sales cadences can typically be configured.

See Referral limits and follow-up and [Referral lead syncs](https://docs.perkville.com/features/referrals/referral-lead-syncs.md) for details.

### **Point Expiration Notifications**

Encourage customers to redeem rewards before their points expire.

* **Point Expiration Warning:** Sent to a customer alerting them that they have points that will expire soon.

### Challenge Emails

Boost engagement in challenges with timely updates.

* **Challenge Invitation:** Invites customers to join a challenge.
* **Challenge Progress Update:** Sent to a customer who has joined the challenge after earning progress in the challenge.
* **Challenge Completion:** Sent to a customer who has joined the challenge after completing the challenge.

***

## Emails Sent to Business Staff

Perkville also keeps your staff informed with automated notifications and reports on program activity.

{% hint style="info" %}
Receiving a staff notification is controlled by more than the staff member's title or role name. The staff member must have the applicable **Receive email notifications** role permission enabled, must have the corresponding **Business notifications** preference enabled in their own Perkville settings, and must have access to the relevant location when the notification is location-specific.
{% endhint %}

### Reports

* **Daily Report:** Sent to eligible business staff summarizing activity at their business.
* **Weekly Report:** Sent to eligible business staff based on role permissions and notification preferences.
* **Monthly Report:** Sent to eligible business staff based on role permissions and notification preferences.

### Notifications

* **Staff Added:** Sent to a new staff member after they are added as a staff member at a business.
* **Business Live Alert:** Sent to eligible staff when their business first goes live on Perkville.
* **Reward/Offer Redemption Alert:** Sent to eligible staff when a customer claims an offer or redeems a reward. Delivery depends on the staff role's **Receive email notifications** permission, the staff member's **Business notifications** preferences, and location access.
* **Upload Limit Exceeded:** Sent to eligible staff when a batch upload fails due to too many records.
* **Batch Upload Report:** Sent to eligible staff after a batch upload completes successfully.
* **Referral Completed:** Sent to eligible staff after a new customer has been successfully referred to their business.
* **Coupon Reminder:** For businesses that have uploaded custom coupon codes, sent to eligible staff when codes are running low.
* **Invite Upload Report:** Sent to eligible staff after an invite upload completes successfully.
* **Plan Overage Warning:** Sent to eligible staff for legacy-billing accounts when the plan's transaction maximum is exceeded.

{% hint style="warning" %}
The **Plan Overage Warning** is only for businesses that are on Perkville's legacy billing. If you are on per-location pricing, this does not apply.
{% endhint %}

***

## Emails Sent to Customers or Staff

* **Confirm Email Address:** Sent when registering or changing a primary email address.
* **Account Merge Request:** A confirmation email sent during the account merge process.
* **Account Merge Confirmation:** Sent to a user after they have successfully merged two accounts.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.perkville.com/features/emails.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
