> 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/integrations/integration-reference/virtuagym.md).

# Virtuagym

Connect Virtuagym attendance, membership and referral workflows to Perkville.

## Integration at a glance <a href="#capabilities-and-use-cases" id="capabilities-and-use-cases"></a>

{% columns %}
{% column %}

### Visits & purchases

* **Attendance** — Reward club check-ins and attended events.
  {% endcolumn %}

{% column %}

### Membership tiers & eligibility

* **Membership tier rewards** — Offer points, instant rewards, or both for qualifying active membership tiers, including when members join at a higher tier or upgrade. Each tier is earned once. See [Membership tiers](https://docs.perkville.com/features/earning-rules/membership-tiers.md) for setup.

Uses the first active membership name selected by the member-data workflow and the mapped member status. Memberships and tier rewards must be enabled in Perkville, with the qualifying membership types and active statuses syncing from your system.

* **Other earning rules** — Configured sign-up and anniversary rewards remain separate.
  {% endcolumn %}
  {% endcolumns %}

### Referrals & rewards

* **Referrals** — Send Perkville referral leads to Virtuagym through a configured workflow.
* **Rewards** — Support redemption of club credits. Purchase-based earning is not included in the listed integration.

Your configured rules determine which eligible activities award points and which workflows are enabled.

## **Integration Steps**

To begin your integration with Virtuagym, please submit the required information via this secure site:\
👉 [**https://onetimesecret.com/**](https://onetimesecret.com/)

#### Step 1: Submit Your Credentials Securely

1. Go to <https://onetimesecret.com> and click **“Create a secret link”**.
2. Paste the requested information into the form.
3. If you choose to set a password, please email your **Customer Success Representative** the **link** and **password** separately to ensure a secure transfer.

#### Step 2: Provide the Following Information

* **Club ID(s)** (optional):
  * If you operate a single club, you can skip this.
  * If you have a **superclub** with multiple sub-clubs, contact Virtuagym to retrieve the **sub-club IDs**.
* **Club Key**:
  * Found in Virtuagym under:\
    `Business Settings → Business Info → Advanced`
  * If you're a superclub, use the **superclub's** Club Key.
* **API Key**:
  * Can be requested in Virtuagym from the same section:\
    `Business Settings → Business Info → Advanced`

## FAQ

### Can we reward members for attending a personal training appointment?

Virtuagym’s appointment schedule can include the activity, participant and attendance status. Ask your Customer Success Manager to verify which of those details your connection provides for the appointment types you want to reward. Before enabling the earning rule, test that a member earns points for an attended session and that a booking alone does not trigger points.

### Can a reward apply club credits?

Club-credit redemption is listed as supported. Ask your CSR to configure and test the specific reward-to-credit mapping.

See the [Virtuagym partner profile](https://partners.perkville.com/partners/virtuagym) for additional integration information.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.perkville.com/integrations/integration-reference/virtuagym.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
