---
title: "Use Case: Referral Milestone"
slug: "use-case-referral-milestone"
updated: 2026-06-10T15:11:17Z
published: 2026-06-10T15:11:17Z
canonical: "docs.xtremepush.com/use-case-referral-milestone"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xtremepush.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Use Case: Referral Milestone

In this example, a user must make five referrals by the end of March. This quest only unlocks once the user has completed a previous quest for making three referrals. The reward for completing this quest is 500 tokens

The configuration for this example is as follows:

## Specify Desired Action and Occurrence

1. **Desired Action**: Select the event , for example *referralmade*, with a target of 5. This means a user must make 5 referrals to complete this quest.
2. **Occurrence**: Set the occurrence to **One Time**, as the desired action of five referrals, must only occur once.

![](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/5b8cd5b5eb2ca7d4e1d634e1daa639fddf6100e72963e641756d6f8416c73830-29(1).png)

## Specify Quest Restrictions

The quest must have the following restrictions

- Select the *Refer 3 Friends Before March* quest in the **Unlocks After Completing** drop-down. This ensures that this quest is unlocked only after users complete the existing quest requiring 3 referrals.
- Select the **Immediately** checkbox. This ensures that the quest is immediately available to users after you finish the quest configuration.
- Set the quest completion date to **1st March** as the quest must be completed before March. After this date, the quest is deactivated and no longer visible to users.

![](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/41657443263557c9c415cf9700a6e74816cadd14ca85eff04a1cca27d22b4ed0-30(1).png)

## Specify the Quest Reward

Set the reward to 500 tokens for completing the quest.

![](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/8d0e71524223a959985f84560c3c029442739a2c7f30a48b7db9d558743ee85a-31(1).png)

## Manage Quest Visibility

Set the title to *Refer 5 Friends Before March* and then upload an relevant icon.

![](https://cdn.document360.io/b056e88b-f6c1-4bd2-b5b8-08e9336a17c9/Images/Documentation/07e492f904c06a85b267ff25bf9c3d5d4e31258f83cff6c39e7063560bf299fa-32(1).png)