# Challenges

You can create challenges to incentivize activity during a specified date range, or if you have membership you can create a new member challenge.

You can customize the challenges to have any number of requirements such as:

* Spend $100 on retail
* Check into our club 8 times
* Take 4 classes
* Refer one friend

## **Who can participate in a challenge?**

Challenges may be restricted to...

* Active members
* Active rewards program members
* Certain locations
* [Custom attributes](https://docs.perkville.com/features/customers/custom-attributes)
* Within a specified number of days of a member joining

{% hint style="warning" %}
Challenges for new members is only available if your business offers memberships
{% endhint %}

## **What activities can be required in a challenge?**

The challenge requirements can be tied to a standard earning rule in your reward program (checking into your business, spending on retail, etc.) as well as [**Progress Activities**](https://docs.perkville.com/features/earning-rules/activities) which are 0 point transactions logged on the user profile.&#x20;

{% hint style="info" %}
If your business want to track certain things, like attending a class or signing up for a membership, but not give points for it, you would make use of Progress Activities.
{% endhint %}

## **How are customers notified about a challenge?**

The challenge is marketed in emails and on the site.

There are challenge-specific emails sent from Perkville:&#x20;

* Challenge invite
  * Customers must accept the challenge by the end of the challenge period in order to earn points.&#x20;
  * Customers may navigate to the challenge URL at any time while the challenge is active to accept the challenge. This URL is not unique to each user and is configured on the challenge. Feel free to pick a memorable, easy to share URL!
* Challenge progress update
* Challenge complete

Customers can choose to opt out of challenge-related emails if they so choose, via their profile email settings.

Perkville automatically send challenge invitations to eligible customers when they do an activity in the challenge.

Challenges will be displayed on your rewards website and customers can view their challenge activity at any time in their rewards account.

## When are challenge rewards distributed?

#### Completion Reward

When the challenge is completed within the allotted time, the challenge reward is immediately distributed.&#x20;

If the challenge ends, a participant can still have [progress added via backdated activities](https://docs.perkville.com/features/manually-adding-challenge-progress#adding-progress-after-a-challenge-has-ended). These activities must fall within the challenge's eligible date range. At this time, this can only be done via the Perkville API. If they complete the challenge via these backdated progress activities, then the challenge will be marked as complete and their reward will be distributed.

{% hint style="warning" %}
Backdating progress activities to distribute a challenge reward will not work if the participant received the participation reward. Participants cannot earn both the participation reward and completion reward.
{% endhint %}

#### Participation Reward

Once the challenge ends, anyone who joined the challenge, but did not complete it, will have their participation reward distributed within 3 days.


---

# 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://docs.perkville.com/features/challenges.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.
