> 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/marketing/link-from-the-app/create-event-deep-links.md).
# Create Event Deep Links
#### Overview
PodPlay supports deep linking to both the Events tab and the Book tab of your Club's App. A deep link is a URL that takes a Customer directly to a pre-filtered view, whether that's a filtered Event list or a specific booking experience (with an optional date already selected). This is useful for marketing campaigns, social media posts, QR codes, email newsletters, or any situation where you want Customers to land on exactly the right part of the App without having to navigate or filter.
Deep links are built using your Club's unique subdomain and a set of optional query parameters and path segments appended to the base URL.
### Deep Linking to Events
#### URL Structure
Every deep link starts with your club's base Events URL:
```
https://[clubname].podplay.app/community/events
```
To filter the results, you append one or more **query parameters** to the end of the URL. Query parameters follow this pattern:
* The first parameter is preceded by a **`?`** (question mark)
* Each additional parameter is separated by a **`&`** (ampersand)
* Parameter values with spaces use a **`+`** in place of each space
The general structure is:
```
https://[clubname].podplay.app/community/events?[parameter1]=[value1]&[parameter2]=[value2]
```
#### Parameters
There are four parameters you can use, in any combination:
| Parameter | What it filters | Format | Example value |
| --------- | --------------- | -------------------- | ---------------------------------------------- |
| `level` | Skill levels | Text | `Beginner`, `Intermediate`, `Advanced` |
| `type` | Event types | Text (spaces as `+`) | `Open+Play`, `Clinic`, `League`, `Social+Play` |
| `tag` | Custom tags | Text (spaces as `+`) | `Members+Only`, `Drill+and+Play` |
| `date` | Calendar dates | `YYYY-MM-DD` | `2026-04-22` |
You only need to include the parameters relevant to your use case. Any parameter you leave out will not be applied as a filter.
{% hint style="info" %}
**Parameter values are case-sensitive and must exactly match the level names, Event types, and tags configured in your Dashboard for your environment**. If no events match the combination of filters in the URL, the page will display empty; this is expected behavior.
{% endhint %}
#### Examples
**Filter by a single tag:**
```
https://[clubname].podplay.app/community/events?tag=Members+Only
```
Displays all events tagged "Members Only" (this is only an example; if you do not have this tag in your environment, it will not work).
***
**Filter by level and event type:**
```
https://[clubname].podplay.app/community/events?level=Advanced&type=Open+Play
```
Displays Advanced-level Open Play events. The `level` parameter comes first, followed by `&`, then the `type` parameter.
***
**Filter by event type and tag:**
```
https://[clubname].podplay.app/community/events?type=Open+Play&tag=women
```
Displays Open Play events tagged "women." The `type` parameter comes first, followed by `&`, then the `tag` parameter.
***
**Filter by all three parameters:**
```
https://[clubname].podplay.app/community/events?level=Intermediate&type=Open+Play&tag=women
```
Displays Intermediate Open Play events tagged "women." Each additional parameter is appended with `&`. If no event matches all three filters simultaneously, the page will show no results — this is not an error; it simply means no events currently have that exact combination.
***
**Filter by date:**
```
https://[clubname].podplay.app/community/events?date=2026-04-22
```
Opens the event calendar to a specific date. The date is added as a `date` query parameter in `YYYY-MM-DD` format.
***
**Filter by date combined with other parameters:**
```
https://[clubname].podplay.app/community/events?date=2026-04-22&type=Open+Play&tag=women
```
Opens the calendar to April 22, 2026, filtered to Open Play events tagged "women." The `date` parameter works alongside any combination of `level`, `type`, and `tag`.
***
### How to Build Your Own Deep Link
1. Start with your base URL: `https://[clubname].podplay.app/community/events`
2. Add a `?` immediately after `events` (no space)
3. Add your first parameter in the format `key=value` (e.g., `type=Open+Play`)
4. If you need a second parameter, add `&` immediately after the first value, then add the next `key=value` pair
5. Repeat step 4 for any additional parameters
6. Replace any spaces in parameter values with `+`
**Example build:**
| Step | URL |
| -------------- | ------------------------------------------------------------------------------------------------------------- |
| Base URL | `https://[clubname].podplay.app/community/events` |
| Add event type | `https://[clubname].podplay.app/community/events?type=Open+Play` |
| Add level | `https://[clubname].podplay.app/community/events?type=Open+Play&level=Intermediate` |
| Add tag | `https://[clubname].podplay.app/community/events?type=Open+Play&level=Intermediate&tag=women` |
| Add date | `https://[clubname].podplay.app/community/events?type=Open+Play&level=Intermediate&tag=women&date=2026-04-22` |
### Event Deep Link FAQs
Does the order of parameters in the URL matter?
No. The parameters can be added in any order and will produce the same filtered result.
What if I use a level, type, or tag that doesn't exist in my Dashboard?
The page will load but display no events. Double-check that the value in your URL exactly matches what is configured in your environment, including capitalization and spacing.
Can I use a deep link as a QR code?
Yes. Any URL generator that creates a QR code from a web address will work. Paste your deep link into the generator and the resulting QR code will open the filtered Events page when scanned.
Can I link to a specific event rather than a filtered list?
Yes. To get a direct link to a specific event:
1. Log in to your PodPlay Dashboard and open the event you want to link to.
2. In the event's side panel, click the **three dots** in the bottom left corner.
3. Select **"Generate Signup Link."** This is the deep link to that specific event — you can copy it and share it anywhere.
{% hint style="success" %}
Selecting **"Open in web app"** from the same menu will open the event in the front-end of the app. The URL in your browser is the same link a Customer will land on when they click a deep link to that event, so this is a useful way to preview exactly what the Customer will see.
{% endhint %}
***
### Deep Linking to Reservations
#### Overview
If your Club offers multiple booking experiences, for example, separate court types such as pickleball, padel, or table tennis, you can deep link Customers directly to a specific booking experience on the Book tab of your App. You can also include a specific date in the link so the App opens directly to that day.
The easiest way to discover your Reservation deep links is to open the front-end of your web app in a browser, navigate to the Book tab, and click the quick filters at the top of the page. The URL in your browser will update as you apply filters and select dates; that URL is your deep link.
#### URL Structure
Every Reservation deep link starts with your Club's base Book URL:
```
https://[clubname].podplay.app/book/[location]
```
Where `[location]` is the URL slug for your specific location (visible in your browser when you navigate to the Book tab).
To filter by booking experience, append a `pod` query parameter:
```
https://[clubname].podplay.app/book/[location]?pod=[experience-slug]
```
To also open the calendar to a specific date, insert the date in `YYYY-MM-DD` format into the URL path, between the location and the query parameter:
```
https://[clubname].podplay.app/book/[location]/YYYY-MM-DD?pod=[experience-slug]
```
#### Parameters
| Element | Where it appears | Format | Example |
| ----------------- | ----------------------------------- | --------------- | ------------------- |
| Location | In the URL path, after `/book/` | Kebab-case slug | `st-pete` |
| Date *(optional)* | In the URL path, after the location | `YYYY-MM-DD` | `2026-04-21` |
| `pod` | Query parameter after `?` | Kebab-case slug | `pickleball-courts` |
{% hint style="info" %}
**The `pod` value must match the slug for that booking experience as configured in your environment**. Use the front-end quick filters to confirm the exact slugs for your Club.
{% endhint %}
#### Examples
**Link to a specific booking experience (no date):**
```
https://[clubname].podplay.app/book/[location]?pod=pickleball-courts
https://[clubname].podplay.app/book/[location]?pod=padel-courts
https://[clubname].podplay.app/book/[location]?pod=table-tennis
```
Each link opens the Book tab filtered to that court type, with the calendar defaulting to today's date.
**Link to a specific booking experience on a specific date:**
```
https://[clubname].podplay.app/book/[location]/2026-04-19?pod=table-tennis
https://[clubname].podplay.app/book/[location]/2026-04-21?pod=pickleball-courts
```
The date is inserted into the path (after the location slug and before the `?`), and the calendar opens directly to that day filtered to the specified court type.
#### How to Find Your Deep Links
Rather than building Reservation deep links manually, the simplest approach is to let the app generate them for you:
1. Open your Club's web app in a browser and navigate to the **Book** tab.
2. Use the **quick filters** at the top of the page to select the booking experience you want to link to (these are only available if you have different booking experiences).
3. Optionally, select a date on the calendar carosel.
4. Copy the URL from your browser's address bar; this is your deep link.
#### Reservation Deep Link FAQs
What if my Club only has one booking experience?
The `pod` parameter is only needed when your Club has multiple booking experiences. If you have a single experience, the base Book tab URL (`https://[clubname].podplay.app/book/[location]`) will take Customers directly to it.
How is date filtering different between Events and Reservations?
The two use different URL structures. For Events, the date is a query parameter (`?date=YYYY-MM-DD`) appended after the `?` alongside other filters. For Reservations, the date is inserted directly into the URL path (`/book/[location]/YYYY-MM-DD`) before the `?`.
Can I use a Reservation deep link as a QR code?
Yes. Paste the URL into any QR code generator. When a Customer scans it, they will land on the Book tab filtered to the correct experience and date.
---
# 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/marketing/link-from-the-app/create-event-deep-links.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.