> For the complete documentation index, see [llms.txt](https://btwb.gitbook.io/btwb/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://btwb.gitbook.io/btwb/developers/zapier-triggers.md).

# Zapier Triggers

This page describes the available trigger events for the BTWB Zapier integration. Each trigger fires when a specific action occurs in your gym management system.

### Versions

* **BTWB Zapier Integration 1.0** - Initial release with client, scheduling, and membership triggers
* **BTWB Zapier Integration 1.1** - Added additional scheduling event triggers (late cancel, early cancel, no show, uncheck in, reserved)

### Event Categories

Events are organized into three categories:

* **Client Events** - Actions related to client records
* **Scheduling Events** - Actions related to class scheduling and attendance (check-ins, cancellations, reservations, no-shows)
* **Membership Events** - Actions related to subscription lifecycle

***

### Client Events

#### Client Added

Fires when a new client is created in your system.

*Version Added: BTWB Zapier Integration 1.0*

**Trigger Data:**

```
id              - Unique event identifier
time            - When the event occurred (ISO 8601 timestamp)
organization_id - Your organization identifier
client
    id          - Client record identifier
    member_id   - Member ID (may be null if not assigned)
    first_name  - Client first name
    last_name   - Client last name
    email       - Client email address
starting_connection_status - Initial connection status of the client
```

#### Client Archived

Fires when a client record is archived (soft-deleted).

*Version Added: BTWB Zapier Integration 1.0*

**Trigger Data:**

```
id              - Unique event identifier
time            - When the event occurred (ISO 8601 timestamp)
organization_id - Your organization identifier
client
    id          - Client record identifier
    member_id   - Member ID
    first_name  - Client first name
    last_name   - Client last name
    email       - Client email address
```

#### Client Details Updated

Fires when a client's profile information is modified.

*Version Added: BTWB Zapier Integration 1.0*

**Trigger Data:**

```
id              - Unique event identifier
time            - When the event occurred (ISO 8601 timestamp)
organization_id - Your organization identifier
client
    id          - Client record identifier
    member_id   - Member ID
    first_name  - Client first name
    last_name   - Client last name
    email       - Client email address
```

***

### Scheduling Events

#### Class Checked In

Fires when a client checks into a scheduled class.

*Version Added: BTWB Zapier Integration 1.0*

**Trigger Data:**

```
id              - Unique event identifier
time            - When the event occurred (ISO 8601 timestamp)
organization_id - Your organization identifier
client
    id          - Client record identifier
    member_id   - Member ID
    first_name  - Client first name
    last_name   - Client last name
    email       - Client email address
class
    id          - Class record identifier
    name        - Name of the class session
    date        - Date of the class
    time        - Start time of the class
class_type
    id          - Class type identifier
    name        - Name of the class type (e.g., "CrossFit", "Yoga")
location
    id          - Location identifier
    name        - Name of the gym location
```

#### Class Late Canceled

Fires when a client late-cancels a class reservation.

*Version Added: BTWB Zapier Integration 1.1*

**Trigger Data:**

```
id              - Unique event identifier
time            - When the event occurred (ISO 8601 timestamp)
organization_id - Your organization identifier
client
    id          - Client record identifier
    member_id   - Member ID
    first_name  - Client first name
    last_name   - Client last name
    email       - Client email address
class
    id          - Class record identifier
    name        - Name of the class session
    date        - Date of the class
    time        - Start time of the class
class_type
    id          - Class type identifier
    name        - Name of the class type (e.g., "CrossFit", "Yoga")
location
    id          - Location identifier
    name        - Name of the gym location
```

#### Class Early Canceled

Fires when a client cancels a class reservation before the late-cancel window.

*Version Added: BTWB Zapier Integration 1.1*

**Trigger Data:**

```
id              - Unique event identifier
time            - When the event occurred (ISO 8601 timestamp)
organization_id - Your organization identifier
client
    id          - Client record identifier
    member_id   - Member ID
    first_name  - Client first name
    last_name   - Client last name
    email       - Client email address
class
    id          - Class record identifier
    name        - Name of the class session
    date        - Date of the class
    time        - Start time of the class
class_type
    id          - Class type identifier
    name        - Name of the class type (e.g., "CrossFit", "Yoga")
location
    id          - Location identifier
    name        - Name of the gym location
```

#### Class No Show

Fires when a client is marked as a no-show for a scheduled class.

*Version Added: BTWB Zapier Integration 1.1*

**Trigger Data:**

```
id              - Unique event identifier
time            - When the event occurred (ISO 8601 timestamp)
organization_id - Your organization identifier
client
    id          - Client record identifier
    member_id   - Member ID
    first_name  - Client first name
    last_name   - Client last name
    email       - Client email address
class
    id          - Class record identifier
    name        - Name of the class session
    date        - Date of the class
    time        - Start time of the class
class_type
    id          - Class type identifier
    name        - Name of the class type (e.g., "CrossFit", "Yoga")
location
    id          - Location identifier
    name        - Name of the gym location
```

#### Class Unchecked In

Fires when a client's check-in to a class is reversed.

*Version Added: BTWB Zapier Integration 1.1*

**Trigger Data:**

```
id              - Unique event identifier
time            - When the event occurred (ISO 8601 timestamp)
organization_id - Your organization identifier
client
    id          - Client record identifier
    member_id   - Member ID
    first_name  - Client first name
    last_name   - Client last name
    email       - Client email address
class
    id          - Class record identifier
    name        - Name of the class session
    date        - Date of the class
    time        - Start time of the class
class_type
    id          - Class type identifier
    name        - Name of the class type (e.g., "CrossFit", "Yoga")
location
    id          - Location identifier
    name        - Name of the gym location
```

#### Class Reserved

Fires when a client reserves a spot in a scheduled class.

*Version Added: BTWB Zapier Integration 1.1*

**Trigger Data:**

```
id              - Unique event identifier
time            - When the event occurred (ISO 8601 timestamp)
organization_id - Your organization identifier
client
    id          - Client record identifier
    member_id   - Member ID
    first_name  - Client first name
    last_name   - Client last name
    email       - Client email address
class
    id          - Class record identifier
    name        - Name of the class session
    date        - Date of the class
    time        - Start time of the class
class_type
    id          - Class type identifier
    name        - Name of the class type (e.g., "CrossFit", "Yoga")
location
    id          - Location identifier
    name        - Name of the gym location
```

***

### Membership Events

#### Subscription Started

Fires when a membership subscription becomes active.

*Version Added: BTWB Zapier Integration 1.0*

**Trigger Data:**

```
id              - Unique event identifier
time            - When the event occurred (ISO 8601 timestamp)
organization_id - Your organization identifier
client
    id          - Client record identifier
    member_id   - Member ID
    first_name  - Client first name
    last_name   - Client last name
    email       - Client email address
subscription
    id          - Subscription record identifier
membership_plan
    id          - Membership plan identifier
    name        - Name of the membership plan
```

#### Subscription Canceled

Fires when a membership subscription is canceled.

*Version Added: BTWB Zapier Integration 1.0*

**Trigger Data:**

```
id              - Unique event identifier
time            - When the event occurred (ISO 8601 timestamp)
organization_id - Your organization identifier
client
    id          - Client record identifier
    member_id   - Member ID
    first_name  - Client first name
    last_name   - Client last name
    email       - Client email address
subscription
    id          - Subscription record identifier
membership_plan
    id          - Membership plan identifier
    name        - Name of the membership plan
```

#### Subscription Expired

Fires when a membership subscription reaches its end date and expires.

*Version Added: BTWB Zapier Integration 1.0*

**Trigger Data:**

```
id              - Unique event identifier
time            - When the event occurred (ISO 8601 timestamp)
organization_id - Your organization identifier
client
    id          - Client record identifier
    member_id   - Member ID
    first_name  - Client first name
    last_name   - Client last name
    email       - Client email address
subscription
    id          - Subscription record identifier
membership_plan
    id          - Membership plan identifier
    name        - Name of the membership plan
```

#### Subscription Past Due

Fires when a subscription payment fails and the subscription becomes past due.

*Version Added: BTWB Zapier Integration 1.0*

**Trigger Data:**

```
id              - Unique event identifier
time            - When the event occurred (ISO 8601 timestamp)
organization_id - Your organization identifier
client
    id          - Client record identifier
    member_id   - Member ID
    first_name  - Client first name
    last_name   - Client last name
    email       - Client email address
subscription
    id          - Subscription record identifier
membership_plan
    id          - Membership plan identifier
    name        - Name of the membership plan
```

#### Subscription Pause Started

Fires when a membership subscription is paused (temporarily suspended).

*Version Added: BTWB Zapier Integration 1.0*

**Trigger Data:**

```
id              - Unique event identifier
time            - When the event occurred (ISO 8601 timestamp)
organization_id - Your organization identifier
client
    id          - Client record identifier
    member_id   - Member ID
    first_name  - Client first name
    last_name   - Client last name
    email       - Client email address
subscription
    id          - Subscription record identifier
membership_plan
    id          - Membership plan identifier
    name        - Name of the membership plan
```

#### Subscription Pause Ended

Fires when a paused membership subscription resumes.

*Version Added: BTWB Zapier Integration 1.0*

**Trigger Data:**

```
id              - Unique event identifier
time            - When the event occurred (ISO 8601 timestamp)
organization_id - Your organization identifier
client
    id          - Client record identifier
    member_id   - Member ID
    first_name  - Client first name
    last_name   - Client last name
    email       - Client email address
subscription
    id          - Subscription record identifier
membership_plan
    id          - Membership plan identifier
    name        - Name of the membership plan
```

#### Subscription Scheduled

Fires when a membership subscription is scheduled to start at a future date.

*Version Added: BTWB Zapier Integration 1.0*

**Trigger Data:**

```
id              - Unique event identifier
time            - When the event occurred (ISO 8601 timestamp)
organization_id - Your organization identifier
client
    id          - Client record identifier
    member_id   - Member ID
    first_name  - Client first name
    last_name   - Client last name
    email       - Client email address
subscription
    id          - Subscription record identifier
membership_plan
    id          - Membership plan identifier
    name        - Name of the membership plan
```

***

### Common Fields

All events include these standard fields:

| Field            | Description                                                                        |
| ---------------- | ---------------------------------------------------------------------------------- |
| id               | Unique identifier for this event. Use to deduplicate if a Zap runs multiple times. |
| time             | ISO 8601 timestamp when the event occurred. Example: `2024-01-15T14:30:00Z`        |
| organization\_id | Your gym organization identifier. Useful when managing multiple locations.         |

***

### Notes

* Events are returned in reverse chronological order (newest first)
* Zapier polls for new events periodically
* Each event fires once per occurrence
* Client email may be null if the client has no email on file
* Member ID may be null if not assigned to the client


---

# 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://btwb.gitbook.io/btwb/developers/zapier-triggers.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.
