> 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/referrals.md).
# Referrals
The **Referrals** feature in Perkville enables businesses to grow organically by rewarding members for bringing in new customers. With this system, existing members can refer friends, family, or colleagues and earn points when their referrals sign up and complete qualifying activities. This helps increase membership while rewarding customer advocacy.
Referrals can be shared via email, social media, or personalized referral links, making it easy for members to promote your business. Referred friends can receive a referral offer, and the referring customer can earn a reward when the referral is completed according to your program settings.
{% hint style="info" %}
Use referrals to...
* Encourage member-driven growth
* Reward loyalty and advocacy
* Track referral success and performance
* Customize referral messages and point values
{% endhint %}
## Referral flow
{% stepper %}
{% step %}
### Share referral offer
Your customers view the referral page where they are prompted to share [your referral offer](/features/referrals/configuring-your-referral-program/referral-offer.md) with their friends. Perkville prompts customers to visit this page on your loyalty program's web pages and in program emails.
{% endstep %}
{% step %}
## Receive referral offer
Your customer's friend receives the [referral offer](/features/referrals/configuring-your-referral-program/referral-offer.md), typically via text message or email.
{% endstep %}
{% step %}
## View offer details
The friend clicks on the [referral offer](/features/referrals/configuring-your-referral-program/referral-offer.md) to view its details.
{% endstep %}
{% step %}
## Claim Offer
The friend claims the [referral offer](/features/referrals/configuring-your-referral-program/referral-offer.md).
{% endstep %}
{% step %}
### Receive Voucher
The friend receives the referral offer voucher with instructions on how to use it. Perkville vouchers support various redemption methods, including manual processing, single-use or multi-use coupon codes, and in some cases, automatic integration with your point of sale or membership system.
{% endstep %}
{% step %}
### Earn points for completed referral
When the friend [completes a qualifying action](/features/referrals/completing-a-referral.md) defined by you, such as making a purchase or buying a membership, your customer earns the configured reward for the completed referral.
{% endstep %}
{% endstepper %}
---
# 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 dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.perkville.com/features/referrals.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
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.
