# Mindbody

> Run your Mindbody studio from workflows: find and add clients, book them into classes and appointments, read staff, locations, pricing options and sales, and start a workflow when a client joins, a sale is made or an appointment is booked.

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/mindbody

## Actions

### Add client

Add a new client to the business. Mindbody refuses a second client with the same first name, last name and email.

**Inputs**

- First name (`first_name`, text, required): The client's first name.
- Last name (`last_name`, text, required): The client's last name.
- Email (`email`, text): The client's email address.
- Mobile phone (`mobile_phone`, text): The client's mobile number.
- Birthday (`birth_date`, date): The client's date of birth.
- Street address (`address_line_1`, text): The first address line.
- City (`city`, text): The client's city.
- State or province (`state`, text): The client's state.
- Postal code (`postal_code`, text): The client's postal code.
- Staff notes (`notes`, text): Notes for staff on the client's account; clients don't see them.
- Prospect (`is_prospect`, true/false): Mark the client as a prospect (a lead who hasn't bought yet).
- Home location (`home_location_id`, text): The location the client mostly visits.
- Account emails (`send_account_emails`, true/false): Whether the client receives Mindbody's account emails.

**Outputs**

- `client` (object): The client

**Example output**

```json
{
  "client": {
    "AccountBalance": 0,
    "Active": true,
    "AddressLine1": "1 Elm St",
    "BirthDate": "1990-04-01T00:00:00",
    "City": "San Luis Obispo",
    "Country": "US",
    "CreationDate": "2026-11-05T10:12:00",
    "Email": "jo@example.com",
    "FirstName": "Jo",
    "HomeLocation": {
      "Address": "100 Main St",
      "Address2": "",
      "City": "San Luis Obispo",
      "Description": "Our main studio",
      "HasClasses": true,
      "Id": 1,
      "Name": "Downtown Studio",
      "Phone": "8055550100",
      "PostalCode": "93401",
      "SiteId": -99,
      "StateProvCode": "CA"
    },
    "HomePhone": "",
    "Id": "100015678",
    "IsProspect": false,
    "LastModifiedDateTime": "2026-11-05T10:12:00",
    "LastName": "Bloggs",
    "MobilePhone": "8055550123",
    "Notes": "",
    "PostalCode": "93401",
    "State": "CA",
    "Status": "Non-Member",
    "UniqueId": 100015678
  }
}
```

### Book appointment

Book an appointment for a client with a staff member at a location.

**Inputs**

- Client ID (`client_id`, text, required): The client's ID in Mindbody, from 'List clients' or an earlier step.
- Location (`location_id`, text, required): Where the appointment is.
- Staff member (`staff_id`, text, required): Who the appointment is with.
- Session type (`session_type_id`, text, required): The kind of appointment, such as a 60-minute massage.
- Start (`start_date_time`, date and time, required): When the appointment starts.
- End (`end_date_time`, date and time): When it ends. Leave empty for the session type's usual length.
- Notes (`notes`, text): Notes on the appointment.
- Staff requested (`staff_requested`, true/false): The client asked for this staff member by name.
- Send email (`send_email`, true/false): Send the client Mindbody's automatic email for this, if the business has it set up. Off unless you turn it on.
- Use a pricing option (`apply_payment`, true/false): Pay with a pricing option the client owns. Mindbody does this unless you turn it off.

**Outputs**

- `appointment` (object): The appointment

**Example output**

```json
{
  "appointment": {
    "ClientId": "100015678",
    "Duration": 60,
    "EndDateTime": "2026-11-10T15:00:00",
    "FirstAppointment": true,
    "GenderPreference": "None",
    "Id": 51234,
    "LocationId": 1,
    "Notes": "",
    "ProgramId": 22,
    "SessionTypeId": 5,
    "StaffId": 100000279,
    "StaffRequested": false,
    "StartDateTime": "2026-11-10T14:00:00",
    "Status": "Booked"
  }
}
```

### Book client into class

Book a client into a class, or onto its waiting list.

**Inputs**

- Client ID (`client_id`, text, required): The client's ID in Mindbody, from 'List clients' or an earlier step.
- Class ID (`class_id`, text, required): The class's ID, from 'List classes' or an earlier step.
- Require payment (`require_payment`, true/false): Only book if the client has a pricing option that pays for it.
- Waiting list (`waitlist`, true/false): Add the client to the waiting list.
- Send email (`send_email`, true/false): Send the client Mindbody's automatic email for this, if the business has it set up. Off unless you turn it on.
- Pricing option to use (`client_service_id`, text): The ID of a pricing option the client owns to pay for this.

**Outputs**

- `visit` (object): The booking

**Example output**

```json
{
  "visit": {
    "AppointmentId": 0,
    "ClassId": 3300,
    "ClientId": "100015678",
    "EndDateTime": "2026-11-07T09:00:00",
    "Id": 9001,
    "LastModifiedDateTime": "2026-11-05T10:20:00",
    "LateCancelled": false,
    "LocationId": 1,
    "Missed": false,
    "Name": "Morning Flow",
    "ServiceName": "10 class pass",
    "SignedIn": false,
    "StaffId": 100000279,
    "StartDateTime": "2026-11-07T08:00:00",
    "WebSignup": false
  }
}
```

### Cancel appointment

Cancel an appointment, on time or as a late cancellation.

**Inputs**

- Appointment ID (`appointment_id`, text, required): The appointment's ID, from 'List appointments' or an earlier step.
- Late cancel (`late_cancel`, true/false): Record it as a late cancellation (the business's late-cancel rules apply).
- Send email (`send_email`, true/false): Send the client Mindbody's automatic email for this, if the business has it set up. Off unless you turn it on.

**Outputs**

- `appointment` (object): The appointment

**Example output**

```json
{
  "appointment": {
    "ClientId": "100015678",
    "Duration": 60,
    "EndDateTime": "2026-11-10T15:00:00",
    "FirstAppointment": true,
    "GenderPreference": "None",
    "Id": 51234,
    "LocationId": 1,
    "Notes": "",
    "ProgramId": 22,
    "SessionTypeId": 5,
    "StaffId": 100000279,
    "StaffRequested": false,
    "StartDateTime": "2026-11-10T14:00:00",
    "Status": "Cancelled"
  }
}
```

### Find open appointment times

Find when staff are free to take a type of appointment, between two days. Times are the business's local time.

**Inputs**

- Session type (`session_type_id`, text, required): The kind of appointment, such as a 60-minute massage.
- From (`start_date`, date): The first day to look. Defaults to today.
- To (`end_date`, date): The last day to look. Defaults to the first.
- Location (`location_id`, text): Only this location.
- Staff member (`staff_id`, text): Only this staff member.
- How many (`limit`, number): How many to return, 1 to 200. Mindbody's default is 100. From 1 to 200.
- Skip (`offset`, number): How many to skip, to get the next page. Starts at 0. At least 0.

**Outputs**

- `availabilities` (list): The open times
- `count` (number): How many came back in this page
- `offset` (number): How many were skipped
- `total` (number): How many there are in all

**Example output**

```json
{
  "availabilities": [
    {
      "BookableEndDateTime": "2026-11-10T16:00:00",
      "EndDateTime": "2026-11-10T17:00:00",
      "Id": 812,
      "Location": {
        "Address": "100 Main St",
        "Address2": "",
        "City": "San Luis Obispo",
        "Description": "Our main studio",
        "HasClasses": true,
        "Id": 1,
        "Name": "Downtown Studio",
        "Phone": "8055550100",
        "PostalCode": "93401",
        "SiteId": -99,
        "StateProvCode": "CA"
      },
      "SessionType": {
        "Category": "Massage",
        "CategoryId": 3,
        "DefaultTimeLength": 60,
        "Id": 5,
        "Name": "60-minute massage",
        "NumDeducted": 1,
        "OnlineDescription": "",
        "ProgramId": 22,
        "Type": "Appointment"
      },
      "Staff": {
        "AppointmentInstructor": true,
        "Bio": "",
        "ClassTeacher": true,
        "DisplayName": "Ashley",
        "Email": "ashley@example.com",
        "FirstName": "Ashley",
        "Id": 100000279,
        "ImageUrl": "",
        "IndependentContractor": false,
        "LastName": "Knight",
        "MobilePhone": "8055550101",
        "Name": "Ashley Knight"
      },
      "StartDateTime": "2026-11-10T09:00:00"
    }
  ],
  "count": 1,
  "offset": 0,
  "total": 1
}
```

### Get class roster

Get a class with everyone booked into it and whether they have signed in.

**Inputs**

- Class ID (`class_id`, text, required): The class's ID, from 'List classes' or an earlier step.

**Outputs**

- `class` (object): The class
- `count` (number): How many are booked in
- `visits` (list): Who is booked in

**Example output**

```json
{
  "class": {
    "ClassDescription": {
      "Category": "Yoga",
      "Description": "An easy-going vinyasa class.",
      "Id": 77,
      "Name": "Morning Flow",
      "Program": {
        "CancelOffset": 12,
        "Id": 21,
        "Name": "Yoga",
        "ScheduleType": "Class"
      },
      "SessionType": {
        "Category": "Massage",
        "CategoryId": 3,
        "DefaultTimeLength": 60,
        "Id": 6,
        "Name": "Yoga",
        "NumDeducted": 1,
        "OnlineDescription": "",
        "ProgramId": 22,
        "Type": "Class"
      }
    },
    "ClassNotes": "",
    "ClassScheduleId": 410,
    "EndDateTime": "2026-11-07T09:00:00",
    "Id": 3300,
    "IsAvailable": true,
    "IsCanceled": false,
    "IsWaitlistAvailable": false,
    "LastModifiedDateTime": "2026-11-01T09:00:00",
    "Location": {
      "Address": "100 Main St",
      "Address2": "",
      "City": "San Luis Obispo",
      "Description": "Our main studio",
      "HasClasses": true,
      "Id": 1,
      "Name": "Downtown Studio",
      "Phone": "8055550100",
      "PostalCode": "93401",
      "SiteId": -99,
      "StateProvCode": "CA"
    },
    "MaxCapacity": 20,
    "Staff": {
      "AppointmentInstructor": true,
      "Bio": "",
      "ClassTeacher": true,
      "DisplayName": "Ashley",
      "Email": "ashley@example.com",
      "FirstName": "Ashley",
      "Id": 100000279,
      "ImageUrl": "",
      "IndependentContractor": false,
      "LastName": "Knight",
      "MobilePhone": "8055550101",
      "Name": "Ashley Knight"
    },
    "StartDateTime": "2026-11-07T08:00:00",
    "Substitute": false,
    "TotalBooked": 8,
    "TotalBookedWaitlist": 0,
    "TotalSignedIn": 0,
    "VirtualStreamLink": "",
    "WebBooked": 5,
    "WebCapacity": 15
  },
  "count": 1,
  "visits": [
    {
      "AppointmentId": 0,
      "ClassId": 3300,
      "ClientId": "100015678",
      "EndDateTime": "2026-11-07T09:00:00",
      "Id": 9001,
      "LastModifiedDateTime": "2026-11-05T10:20:00",
      "LateCancelled": false,
      "LocationId": 1,
      "Missed": false,
      "Name": "Morning Flow",
      "ServiceName": "10 class pass",
      "SignedIn": false,
      "StaffId": 100000279,
      "StartDateTime": "2026-11-07T08:00:00",
      "WebSignup": false
    }
  ]
}
```

### Get client

Get one client's details: contact details, status, balance and home location.

**Inputs**

- Client ID (`client_id`, text, required): The client's ID in Mindbody, from 'List clients' or an earlier step.

**Outputs**

- `client` (object): The client

**Example output**

```json
{
  "client": {
    "AccountBalance": 0,
    "Active": true,
    "AddressLine1": "1 Elm St",
    "BirthDate": "1990-04-01T00:00:00",
    "City": "San Luis Obispo",
    "Country": "US",
    "CreationDate": "2026-11-05T10:12:00",
    "Email": "jo@example.com",
    "FirstName": "Jo",
    "HomeLocation": {
      "Address": "100 Main St",
      "Address2": "",
      "City": "San Luis Obispo",
      "Description": "Our main studio",
      "HasClasses": true,
      "Id": 1,
      "Name": "Downtown Studio",
      "Phone": "8055550100",
      "PostalCode": "93401",
      "SiteId": -99,
      "StateProvCode": "CA"
    },
    "HomePhone": "",
    "Id": "100015678",
    "IsProspect": false,
    "LastModifiedDateTime": "2026-11-05T10:12:00",
    "LastName": "Bloggs",
    "MobilePhone": "8055550123",
    "Notes": "",
    "PostalCode": "93401",
    "State": "CA",
    "Status": "Non-Member",
    "UniqueId": 100015678
  }
}
```

### List appointments

List booked appointments between two days, for everyone or one staff member, location or client. Gets one page.

**Inputs**

- From (`start_date`, date): The first day to include. Defaults to today.
- To (`end_date`, date): The last day to include. Defaults to the first.
- Staff member (`staff_id`, text): Only this staff member.
- Location (`location_id`, text): Only this location.
- Client ID (`client_id`, text): Only this client's appointments.
- How many (`limit`, number): How many to return, 1 to 200. Mindbody's default is 100. From 1 to 200.
- Skip (`offset`, number): How many to skip, to get the next page. Starts at 0. At least 0.

**Outputs**

- `appointments` (list): The appointments
- `count` (number): How many came back in this page
- `offset` (number): How many were skipped
- `total` (number): How many there are in all

**Example output**

```json
{
  "appointments": [
    {
      "ClientId": "100015678",
      "Duration": 60,
      "EndDateTime": "2026-11-10T15:00:00",
      "FirstAppointment": true,
      "GenderPreference": "None",
      "Id": 51234,
      "LocationId": 1,
      "Notes": "",
      "ProgramId": 22,
      "SessionTypeId": 5,
      "StaffId": 100000279,
      "StaffRequested": false,
      "StartDateTime": "2026-11-10T14:00:00",
      "Status": "Booked"
    }
  ],
  "count": 1,
  "offset": 0,
  "total": 1
}
```

### List classes

List scheduled classes between two days, with their teacher, location and how full they are. Gets one page.

**Inputs**

- From (`start_date`, date): The first day to include. Defaults to today.
- To (`end_date`, date): The last day to include. Defaults to today.
- Location (`location_id`, text): Only this location.
- Staff member (`staff_id`, text): Only this staff member.
- Service category (`program_id`, text): Only this service category (Mindbody calls them programs).
- Hide canceled (`hide_canceled`, true/false): Leave out canceled classes.
- How many (`limit`, number): How many to return, 1 to 200. Mindbody's default is 100. From 1 to 200.
- Skip (`offset`, number): How many to skip, to get the next page. Starts at 0. At least 0.

**Outputs**

- `classes` (list): The classes
- `count` (number): How many came back in this page
- `offset` (number): How many were skipped
- `total` (number): How many there are in all

**Example output**

```json
{
  "classes": [
    {
      "ClassDescription": {
        "Category": "Yoga",
        "Description": "An easy-going vinyasa class.",
        "Id": 77,
        "Name": "Morning Flow",
        "Program": {
          "CancelOffset": 12,
          "Id": 21,
          "Name": "Yoga",
          "ScheduleType": "Class"
        },
        "SessionType": {
          "Category": "Massage",
          "CategoryId": 3,
          "DefaultTimeLength": 60,
          "Id": 6,
          "Name": "Yoga",
          "NumDeducted": 1,
          "OnlineDescription": "",
          "ProgramId": 22,
          "Type": "Class"
        }
      },
      "ClassNotes": "",
      "ClassScheduleId": 410,
      "EndDateTime": "2026-11-07T09:00:00",
      "Id": 3300,
      "IsAvailable": true,
      "IsCanceled": false,
      "IsWaitlistAvailable": false,
      "LastModifiedDateTime": "2026-11-01T09:00:00",
      "Location": {
        "Address": "100 Main St",
        "Address2": "",
        "City": "San Luis Obispo",
        "Description": "Our main studio",
        "HasClasses": true,
        "Id": 1,
        "Name": "Downtown Studio",
        "Phone": "8055550100",
        "PostalCode": "93401",
        "SiteId": -99,
        "StateProvCode": "CA"
      },
      "MaxCapacity": 20,
      "Staff": {
        "AppointmentInstructor": true,
        "Bio": "",
        "ClassTeacher": true,
        "DisplayName": "Ashley",
        "Email": "ashley@example.com",
        "FirstName": "Ashley",
        "Id": 100000279,
        "ImageUrl": "",
        "IndependentContractor": false,
        "LastName": "Knight",
        "MobilePhone": "8055550101",
        "Name": "Ashley Knight"
      },
      "StartDateTime": "2026-11-07T08:00:00",
      "Substitute": false,
      "TotalBooked": 8,
      "TotalBookedWaitlist": 0,
      "TotalSignedIn": 0,
      "VirtualStreamLink": "",
      "WebBooked": 5,
      "WebCapacity": 15
    }
  ],
  "count": 1,
  "offset": 0,
  "total": 1
}
```

### List client visits

List a client's class and appointment visits between two days, past or booked. Gets one page.

**Inputs**

- Client ID (`client_id`, text, required): The client's ID in Mindbody, from 'List clients' or an earlier step.
- From (`start_date`, date): The first day to include.
- To (`end_date`, date): The last day to include. Defaults to today.
- Unpaid only (`unpaid_only`, true/false): Only visits not yet paid for.
- Order (`order`, text): Newest or oldest first. One of: `desc` (Newest first), `asc` (Oldest first).
- How many (`limit`, number): How many to return, 1 to 200. Mindbody's default is 100. From 1 to 200.
- Skip (`offset`, number): How many to skip, to get the next page. Starts at 0. At least 0.

**Outputs**

- `count` (number): How many came back in this page
- `offset` (number): How many were skipped
- `total` (number): How many there are in all
- `visits` (list): The visits

**Example output**

```json
{
  "count": 1,
  "offset": 0,
  "total": 1,
  "visits": [
    {
      "AppointmentId": 0,
      "ClassId": 3300,
      "ClientId": "100015678",
      "EndDateTime": "2026-11-07T09:00:00",
      "Id": 9001,
      "LastModifiedDateTime": "2026-11-05T10:20:00",
      "LateCancelled": false,
      "LocationId": 1,
      "Missed": false,
      "Name": "Morning Flow",
      "ServiceName": "10 class pass",
      "SignedIn": false,
      "StaffId": 100000279,
      "StartDateTime": "2026-11-07T08:00:00",
      "WebSignup": false
    }
  ]
}
```

### List clients

Find clients by name or email, or list those changed since a time. Gets one page; run it again with 'Skip' for more.

**Inputs**

- Search (`search_text`, text): A first name, last name or email to search for.
- Include inactive (`include_inactive`, true/false): Include inactive clients too.
- Prospects only (`is_prospect`, true/false): Only clients marked as prospects.
- Changed since (`modified_since`, date and time): Only clients added or changed at or after this time.
- How many (`limit`, number): How many to return, 1 to 200. Mindbody's default is 100. From 1 to 200.
- Skip (`offset`, number): How many to skip, to get the next page. Starts at 0. At least 0.

**Outputs**

- `clients` (list): The clients found
- `count` (number): How many came back in this page
- `offset` (number): How many were skipped
- `total` (number): How many there are in all

**Example output**

```json
{
  "clients": [
    {
      "AccountBalance": 0,
      "Active": true,
      "AddressLine1": "1 Elm St",
      "BirthDate": "1990-04-01T00:00:00",
      "City": "San Luis Obispo",
      "Country": "US",
      "CreationDate": "2026-11-05T10:12:00",
      "Email": "jo@example.com",
      "FirstName": "Jo",
      "HomeLocation": {
        "Address": "100 Main St",
        "Address2": "",
        "City": "San Luis Obispo",
        "Description": "Our main studio",
        "HasClasses": true,
        "Id": 1,
        "Name": "Downtown Studio",
        "Phone": "8055550100",
        "PostalCode": "93401",
        "SiteId": -99,
        "StateProvCode": "CA"
      },
      "HomePhone": "",
      "Id": "100015678",
      "IsProspect": false,
      "LastModifiedDateTime": "2026-11-05T10:12:00",
      "LastName": "Bloggs",
      "MobilePhone": "8055550123",
      "Notes": "",
      "PostalCode": "93401",
      "State": "CA",
      "Status": "Non-Member",
      "UniqueId": 100015678
    }
  ],
  "count": 1,
  "offset": 0,
  "total": 1
}
```

### List locations

List the business's locations, with their addresses.

**Inputs**: None.

**Outputs**

- `count` (number): How many there are
- `locations` (list): The locations

**Example output**

```json
{
  "count": 1,
  "locations": [
    {
      "Address": "100 Main St",
      "Address2": "",
      "City": "San Luis Obispo",
      "Description": "Our main studio",
      "HasClasses": true,
      "Id": 1,
      "Name": "Downtown Studio",
      "Phone": "8055550100",
      "PostalCode": "93401",
      "SiteId": -99,
      "StateProvCode": "CA"
    }
  ]
}
```

### List pricing options

List the passes, memberships and drop-ins the business sells, with their prices. Gets one page.

**Inputs**

- Service category (`program_id`, text): Only this service category (Mindbody calls them programs).
- Session type (`session_type_id`, text): Only pricing options that pay for this session type.
- Location for tax (`location_id`, text): Work out tax for this location. It doesn't narrow the list.
- Sold online (`sell_online`, true/false): Only those sold online.
- Include discontinued (`include_discontinued`, true/false): Include pricing options no longer sold.
- How many (`limit`, number): How many to return, 1 to 200. Mindbody's default is 100. From 1 to 200.
- Skip (`offset`, number): How many to skip, to get the next page. Starts at 0. At least 0.

**Outputs**

- `count` (number): How many came back in this page
- `offset` (number): How many were skipped
- `services` (list): The pricing options
- `total` (number): How many there are in all

**Example output**

```json
{
  "count": 1,
  "offset": 0,
  "services": [
    {
      "Count": 10,
      "Discontinued": false,
      "ExpirationLength": 90,
      "ExpirationUnit": "Days",
      "Id": "1192",
      "Name": "10 class pass",
      "OnlinePrice": 140,
      "Price": 150,
      "ProductId": 1192,
      "Program": "Yoga",
      "ProgramId": 21,
      "SellOnline": true,
      "Type": "Series"
    }
  ],
  "total": 1
}
```

### List sales

List sales made between two times, with what was bought and how it was paid. Gets one page.

**Inputs**

- From (`start_date_time`, date and time): Sales made at or after this time.
- To (`end_date_time`, date and time): Sales made before this time.
- Sale ID (`sale_id`, text): Only this sale.
- Payment method ID (`payment_method_id`, text): Only sales paid this way.
- How many (`limit`, number): How many to return, 1 to 200. Mindbody's default is 100. From 1 to 200.
- Skip (`offset`, number): How many to skip, to get the next page. Starts at 0. At least 0.

**Outputs**

- `count` (number): How many came back in this page
- `offset` (number): How many were skipped
- `sales` (list): The sales
- `total` (number): How many there are in all

**Example output**

```json
{
  "count": 1,
  "offset": 0,
  "sales": [
    {
      "ClientId": "100015678",
      "Id": 96,
      "LocationId": 1,
      "Payments": [
        {
          "Amount": 150,
          "Id": 103,
          "Method": 14,
          "Notes": "",
          "Type": "Cash"
        }
      ],
      "PurchasedItems": [
        {
          "Description": "10 class pass",
          "DiscountAmount": 0,
          "Id": 1192,
          "IsService": true,
          "Quantity": 1,
          "Returned": false,
          "TaxAmount": 0,
          "TotalAmount": 150,
          "UnitPrice": 150
        }
      ],
      "SaleDateTime": "2026-11-05T16:52:23",
      "SalesRepId": 100000279
    }
  ],
  "total": 1
}
```

### List service categories

List the business's service categories (Mindbody calls them programs), such as Yoga classes or Massage appointments.

**Inputs**

- Kind (`schedule_type`, text): Only categories of this kind. One of: `All`, `Class` (Classes), `Enrollment` (Enrollments), `Appointment` (Appointments), `Resource` (Resources), `Media`, `Arrival` (Arrivals).
- Online only (`online_only`, true/false): Only categories shown online.

**Outputs**

- `count` (number): How many there are
- `programs` (list): The service categories

**Example output**

```json
{
  "count": 1,
  "programs": [
    {
      "CancelOffset": 24,
      "Id": 22,
      "Name": "Massage",
      "ScheduleType": "Appointment"
    }
  ]
}
```

### List session types

List the kinds of class and appointment the business offers, with their usual length.

**Inputs**

- Service category (`program_id`, text): Only this service category (Mindbody calls them programs).
- Online only (`online_only`, true/false): Only types bookable online.

**Outputs**

- `count` (number): How many there are
- `session_types` (list): The session types

**Example output**

```json
{
  "count": 1,
  "session_types": [
    {
      "Category": "Massage",
      "CategoryId": 3,
      "DefaultTimeLength": 60,
      "Id": 5,
      "Name": "60-minute massage",
      "NumDeducted": 1,
      "OnlineDescription": "",
      "ProgramId": 22,
      "Type": "Appointment"
    }
  ]
}
```

### List staff

List the business's staff members. Gets one page.

**Inputs**

- Only staff who (`filters`, list): Narrow the list. Leave empty for everyone. One or more of: `StaffViewable` (Shown to clients), `AppointmentInstructor` (Takes appointments), `ClassInstructor` (Teaches classes), `Male`, `Female`.
- How many (`limit`, number): How many to return, 1 to 200. Mindbody's default is 100. From 1 to 200.
- Skip (`offset`, number): How many to skip, to get the next page. Starts at 0. At least 0.

**Outputs**

- `count` (number): How many came back in this page
- `offset` (number): How many were skipped
- `staff` (list): The staff members
- `total` (number): How many there are in all

**Example output**

```json
{
  "count": 1,
  "offset": 0,
  "staff": [
    {
      "AppointmentInstructor": true,
      "Bio": "",
      "ClassTeacher": true,
      "DisplayName": "Ashley",
      "Email": "ashley@example.com",
      "FirstName": "Ashley",
      "Id": 100000279,
      "ImageUrl": "",
      "IndependentContractor": false,
      "LastName": "Knight",
      "MobilePhone": "8055550101",
      "Name": "Ashley Knight"
    }
  ],
  "total": 1
}
```

### Remove client from class

Cancel a client's booking in a class.

**Inputs**

- Client ID (`client_id`, text, required): The client's ID in Mindbody, from 'List clients' or an earlier step.
- Class ID (`class_id`, text, required): The class's ID, from 'List classes' or an earlier step.
- Late cancel (`late_cancel`, true/false): Record it as a late cancellation (the business's late-cancel rules apply).
- Send email (`send_email`, true/false): Send the client Mindbody's automatic email for this, if the business has it set up. Off unless you turn it on.

**Outputs**

- `class` (object): The class the client left
- `removed` (true/false): True once removed

**Example output**

```json
{
  "class": {
    "ClassDescription": {
      "Category": "Yoga",
      "Description": "An easy-going vinyasa class.",
      "Id": 77,
      "Name": "Morning Flow",
      "Program": {
        "CancelOffset": 12,
        "Id": 21,
        "Name": "Yoga",
        "ScheduleType": "Class"
      },
      "SessionType": {
        "Category": "Massage",
        "CategoryId": 3,
        "DefaultTimeLength": 60,
        "Id": 6,
        "Name": "Yoga",
        "NumDeducted": 1,
        "OnlineDescription": "",
        "ProgramId": 22,
        "Type": "Class"
      }
    },
    "ClassNotes": "",
    "ClassScheduleId": 410,
    "EndDateTime": "2026-11-07T09:00:00",
    "Id": 3300,
    "IsAvailable": true,
    "IsCanceled": false,
    "IsWaitlistAvailable": false,
    "LastModifiedDateTime": "2026-11-01T09:00:00",
    "Location": {
      "Address": "100 Main St",
      "Address2": "",
      "City": "San Luis Obispo",
      "Description": "Our main studio",
      "HasClasses": true,
      "Id": 1,
      "Name": "Downtown Studio",
      "Phone": "8055550100",
      "PostalCode": "93401",
      "SiteId": -99,
      "StateProvCode": "CA"
    },
    "MaxCapacity": 20,
    "Staff": {
      "AppointmentInstructor": true,
      "Bio": "",
      "ClassTeacher": true,
      "DisplayName": "Ashley",
      "Email": "ashley@example.com",
      "FirstName": "Ashley",
      "Id": 100000279,
      "ImageUrl": "",
      "IndependentContractor": false,
      "LastName": "Knight",
      "MobilePhone": "8055550101",
      "Name": "Ashley Knight"
    },
    "StartDateTime": "2026-11-07T08:00:00",
    "Substitute": false,
    "TotalBooked": 8,
    "TotalBookedWaitlist": 0,
    "TotalSignedIn": 0,
    "VirtualStreamLink": "",
    "WebBooked": 5,
    "WebCapacity": 15
  },
  "removed": true
}
```

### Update appointment

Move an appointment, change who it's with or its notes, or mark it confirmed, arrived or completed. Only the fields you fill in change.

**Inputs**

- Appointment ID (`appointment_id`, text, required): The appointment's ID, from 'List appointments' or an earlier step.
- New start (`start_date_time`, date and time): A new start time.
- New end (`end_date_time`, date and time): A new end time.
- Staff member (`staff_id`, text): A different staff member.
- Session type (`session_type_id`, text): A different kind of appointment.
- Notes (`notes`, text): New notes on the appointment.
- Mark as (`status_action`, text): Change the appointment's status. One of: `confirm`, `unconfirm`, `arrive` (Mark arrived), `unarrive` (Undo arrived), `complete` (Mark completed).
- Send email (`send_email`, true/false): Send the client Mindbody's automatic email for this, if the business has it set up. Off unless you turn it on.

**Outputs**

- `appointment` (object): The appointment

**Example output**

```json
{
  "appointment": {
    "ClientId": "100015678",
    "Duration": 60,
    "EndDateTime": "2026-11-10T15:00:00",
    "FirstAppointment": true,
    "GenderPreference": "None",
    "Id": 51234,
    "LocationId": 1,
    "Notes": "",
    "ProgramId": 22,
    "SessionTypeId": 5,
    "StaffId": 100000279,
    "StaffRequested": false,
    "StartDateTime": "2026-11-10T14:00:00",
    "Status": "Booked"
  }
}
```

### Update client

Change a client's details, or make them active or inactive. Only the fields you fill in change.

**Inputs**

- Client ID (`client_id`, text, required): The client's ID in Mindbody, from 'List clients' or an earlier step.
- First name (`first_name`, text): The client's first name. Leave empty to keep it.
- Last name (`last_name`, text): The client's last name. Leave empty to keep it.
- Email (`email`, text): The client's email address. Leave empty to keep it.
- Mobile phone (`mobile_phone`, text): The client's mobile number. Leave empty to keep it.
- Birthday (`birth_date`, date): The client's date of birth. Leave empty to keep it.
- Street address (`address_line_1`, text): The first address line. Leave empty to keep it.
- City (`city`, text): The client's city. Leave empty to keep it.
- State or province (`state`, text): The client's state. Leave empty to keep it.
- Postal code (`postal_code`, text): The client's postal code. Leave empty to keep it.
- Staff notes (`notes`, text): Notes for staff on the client's account; clients don't see them. Leave empty to keep it.
- Prospect (`is_prospect`, true/false): Mark the client as a prospect (a lead who hasn't bought yet).
- Home location (`home_location_id`, text): The location the client mostly visits. Leave empty to keep it.
- Active or inactive (`status`, text): Make the client active or inactive. Leave empty to keep it as it is. One of: `active`, `inactive`.

**Outputs**

- `client` (object): The client

**Example output**

```json
{
  "client": {
    "AccountBalance": 0,
    "Active": true,
    "AddressLine1": "1 Elm St",
    "BirthDate": "1990-04-01T00:00:00",
    "City": "San Luis Obispo",
    "Country": "US",
    "CreationDate": "2026-11-05T10:12:00",
    "Email": "jo@example.com",
    "FirstName": "Jo",
    "HomeLocation": {
      "Address": "100 Main St",
      "Address2": "",
      "City": "San Luis Obispo",
      "Description": "Our main studio",
      "HasClasses": true,
      "Id": 1,
      "Name": "Downtown Studio",
      "Phone": "8055550100",
      "PostalCode": "93401",
      "SiteId": -99,
      "StateProvCode": "CA"
    },
    "HomePhone": "",
    "Id": "100015678",
    "IsProspect": false,
    "LastModifiedDateTime": "2026-11-05T10:12:00",
    "LastName": "Bloggs",
    "MobilePhone": "8055550123",
    "Notes": "",
    "PostalCode": "93401",
    "State": "CA",
    "Status": "Non-Member",
    "UniqueId": 100015678
  }
}
```
