> For the complete documentation index, see [llms.txt](https://docs.podplay.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.podplay.app/payments/promo-codes/example-promo-codes.md).

# Example Promo Codes

### Promo Codes for First-Time Clinics

A Promo Code is an effective way to attract first-time Customers, those who have never visited the Club. By combining the **First game only** toggle with **Start Date** and **End Date**, a Club can offer free first-time Clinics during a defined window.

If an Admin wants to offer free Clinics every Sunday in January, the Admin would:

1. Create a new Promo Code
2. Add a name
3. Add a description
4. Add the areas it applies to
5. Set the value (for a free Clinic, 100% off)
6. Flick ON the **First game only** toggle
7. Add a **Start Date** and **End Date** covering January (Dec 31st - Feb 1st)
8. Turn ON **Add Specific Days**
9. Check off Sunday (leave the other remaining days not checked)
10. Save the new Promo Code

When a Customer signs up for a Clinic, the Promo Code will apply only if it is the first Clinic they have ever signed up for. The Customer will:

1. Search for a Clinic
2. Apply the Promo Code
3. Book and save their spot

If the Customer attempts to use the Promo Code on a later Clinic or a Clinic that's not on a Sunday, they will see an error and the code will not apply.

{% hint style="danger" %}
**Test the Promo Code once you have created it**. After verifying it works, send the Promo Code through marketing campaigns or email.
{% endhint %}

### Promo Code for Summer Open Play

By combining the **Limit the number of redemptions** toggle with **Start Date** and **End Date**, a Club can offer a limited amount of free Open Plays during the summer months (or any predefined window of time).

To create this:

1. Navigate to the Promo Code page of the Dashboard
2. Click the blue button at the top of the page to create a new Promo Code
3. Add a name
4. Add a description
5. Add the areas it applies to
6. Set the value (for a free Open Play, 100% off)
7. Flick ON the **Limit the number of redemptions** toggle (set to 10, 20, or 50, up to you)
8. Do NOT turn on the **Allow multiple uses** toggle (this will let a single Customer use the Promo Code multiple times)
9. Add a **Start Date** and **End Date** covering the summer months (Jun 30th - Sept 1st)
10. Save the new Promo Code

When a Customer signs up for an Open Play, the Promo Code will apply only once and provide them with access to a free Open Play. The Customer will:

1. Search for an Open Play
2. Apply the Promo Code
3. Book and save their spot

Setting **Allow multiple uses** to OFF is what enforces the one-game-per-Customer rule. The code will work for any Customer, only once. If the goal is to attract brand-new Customers (rather than reward existing ones), toggle **First game only** on instead. That restricts the code to a Customer's first-ever booking. To cap total redemptions across the Club (for example, the first 20 Customers only), set **Limit the number of redemptions** to the desired number.

{% hint style="danger" %}
**Test the Promo Code once you have created it**. After verifying it works, send the Promo Code through marketing campaigns or email.
{% endhint %}

### Domain-Restricted Promo Codes

An Admin can create a Promo Code that only Customers with a specific email domain can redeem. When the **Restrict to Domain** setting is used, any Customer whose Profile email does not match the restricted domain will be unable to apply the Promo Code.

When entering the domain, do not include the `@` symbol, enter only the domain itself (for example, `PodPlay.app`).

{% hint style="warning" %}
If the Club partners with a business and issues a Domain-Restricted Promo Code, any employees of that business who already have a Profile registered under their personal email will not be able to use the code. To redeem it, the Customer will need to ask the Club Admin to change the email address on their Profile to the restricted domain, which would be their company's domain.
{% endhint %}


---

# 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.podplay.app/payments/promo-codes/example-promo-codes.md?ask=<question>&goal=<endgoal>
```

`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.