Skip to content

Accounts, users, and personas

Top-level accounts

A top-level account is the tenant boundary for a studio, independent teacher, or event business. It owns groups, events, event instances, products, payment configuration, entitlements, and bookings.

The authenticated session selects exactly one account. Consuming systems must not add an account ID to protected requests; the API derives it from that session and filters tenant-owned data accordingly.

Users and participation

A user is any person using the system. A membership connects that user to an account and assigns exactly one persona.

PersonaTypical capabilities
AdministratorFull tenant administration: users, groups, events, rosters, products, bookings, payments, refunds, and account settings. Owners and teachers use it.
AttendeePurchase eligible products, manage personal access, and manage their own bookings.

“Owner” and “teacher” describe a person's relationship to the business, not additional authorization personas. All administration is performed in the admin system. The attendee demo contains no administrative functionality. Authorization is enforced by the API; hiding a control in a client is not a security boundary.

Groups

Groups organize attendees for restricted events—for example, members, beginners, or teacher-training participants. An event instance can be open to everyone, restricted to one or more groups, or not bookable.

Booking SaaS implementation documentation