members.dev
Events and Bookings

Introduction

How events and bookings work in Members, from schedule and pricing to holds, attendance, and cancellations.

Overview

An event is any scheduled activity: a class, workshop, social, or a window of time which can be reserved. A booking reserves a place for a member in that event.

Members can browse and book in the member website and app when an event is member-visible and there is an available slot. Pricing and eligibility can depend on benefits, so you can program special rates which depend on the member's entitlements.

Staff create and manage the events calendar in the admin dashboard event page. The same functionality is available on the Events, Bookings, Event Hosts, Event Resources, and Cancellation Policies APIs.

The building blocks

ConceptWhat it is
EventA named schedule activity (local start and end, timezone), with status, capacity, pricing, and optional recurrence
SlotA bookable window derived from the event (and optional slot duration/interval), with remaining capacity. For example, an event like 'tennis court booking' could have multiple slots throughout the day.
BookingA member's reservation on an event slot, with a price, status, and optional allocated resource
HostA display profile (instructor, coach, speaker) attached to events
LocationA place hosting the event: address, URL for online events, instructions
TagA flexible label on an event for filtering the calendar
ResourceA bookable asset (court, room, bike, salon attendant) with weekly availability and overrides
PriceAn amount, with optional benefit restrictions and deductions for a booking
Cancellation policyRules for refunds, fees, and whether meter deductions are restored when a booking is cancelled

Example events

These configurations show how the same building blocks combine for different activities.

Weekday yoga class

A recurring class every weekday at 18:00 with maximum capacity of 20, an instructor as host, and no resources. Members book a place on each occurrence.

Pricing is set up so a booking either consumes one session credit meter benefit, or charges $20 for members who do not have that credit available (for example guests, or members whose membership does not include session credits).

Members-only workshop

A one-off workshop with a fixed start and end, unlimited capacity, and a guest host. Pricing is free ($0), but restricted to members with an active membership, so members can book without payment or meter deductions. Keep the event member-visible so people can self-serve in the member website and app.

Tennis court hire

Five tennis court resources (Court 1 through Court 5), each with capacity of 1. Bookings attach to a specific court: the member can pick a court number, or Members can auto-allocate the first available one.

There are two parallel events over the same open hours (for example Saturday 09:00–17:00): one for 60-minute slots and one for 120-minute slots. Because capacity lives on the shared court resources, someone cannot book a 60-minute slot on Court 3 if a 120-minute booking already covers that court for an overlapping time, and the reverse is also true.

Ways to work with events and bookings

Next steps