> 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/earning-rules/birthday.md).

# Birthday

The Birthday Earning Rule in Perkville allows you to automatically reward customers with points on their birthdays. To implement this rule, you simply specify the number of points (and/or instant awards) that customers should receive.

Customer birthday data can be imported from your business management platforms, such as your point of sale, membership system, or scheduling system. Additionally, customers have the option to enter their birthdays directly into Perkville. Once set up, Perkville will automatically credit the designated points (and instant rewards) to customers on their birthdays, provided their birthdates are recorded in the system and they are eligible for the program on that date.

{% hint style="info" %}
Perkville-owned integrations always import birthdays, if available in the source data, and not already set in Perkville by the customer or another import.
{% endhint %}

### Adding a birthday award

To add a Birthday Earning Rule via your business dashboard, navigate to the **"Loyalty Program"** section found in the left navigation menu. Scroll down to **"Earning Activities,"** click on the **"+"** icon, and then select **"Birthday"** from the options provided.

### Points and instant awards

A Birthday rule can award **points**, **instant rewards**, or **both**.

When today is the user's birthday, **all** configured awards are added to the customer's account: Any point value, if configured, and every instant reward. (The customer does not choose just one reward.)

{% hint style="info" %}
For customers whose birthdays fall on February 29th on years without that date, they are awarded on March 1st.
{% endhint %}

### "Why didn't I get my birthday award?"

Birthday awards are evaluated on the customer's birthday and are not generally awarded retroactively.

A customer must have an active Perkville account and otherwise be eligible for the program when the birthday occurs. If the customer activates or joins their Perkville account after their birthday has already passed, activating the account does not normally cause that year's Birthday award to be back-awarded.

Changing or adding a birthday after that date has passed also does not normally trigger a retroactive award.

{% hint style="warning" %}
*An example showing how a birthday award may not be awarded*

Imagine on September 1st, a customer changes their birthday from November 10th to February 4th. This person will not receive birthday points for that year, given that February 4th has already passed. The customer will receive the award on February 4th of the following year *(if otherwise eligible)*.
{% endhint %}

If an expected Birthday award is missing, staff should check:

1. The Birthday earning rule is active and has the expected points and/or instant rewards configured.
2. The customer's birthdate was recorded correctly before the birthday occurred.
3. The customer's Perkville account was active and eligible on the birthday.
4. Any [membership](https://docs.perkville.com/features/customers/memberships.md) and [join](https://docs.perkville.com/features/settings/advanced/join-restriction.md) restrictions that apply to earning.
5. The customer's activity history to confirm the award was not already added, adjusted, or voided.

For broader troubleshooting, see [My customer is missing points. What should I do?](https://docs.perkville.com/faqs/points/my-customer-is-missing-points.-what-should-i-do.md).


---

# 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/earning-rules/birthday.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.
