Skip to main content
An instructor is a coach on the gym’s staff. Attach one to a booking when the session is coached rather than a bare court hire - a lesson, a personal training slot, a padel clinic. These endpoints are read-only. Instructors are staff records created and managed by the gym in 1Club, so this API never creates or edits them.

​
Search instructors

Requires the instructors:read scope.
Query parameters:
  • search (optional) - matches on the instructor’s name
  • clubId (optional) - only instructors assigned to that gym
  • sport (optional) - only instructors who list that sport, for example padel
  • bookableOnly (optional) - true or false; when true, only instructors who take one-on-one bookings
  • limit (optional) - 1 to 100, defaults to 25
  • offset (optional) - defaults to 0
Response:
Name matching works the same way as contact search: case-insensitive and cross-script, so maya finds Мая. Only active instructors are returned.

​
Open an instructor

Requires the instructors:read scope.
Returns the same object as one row of the search response. A 404 means no active instructor with that id exists in your organization.

​
Fields that affect booking

isBookable decides whether the coach can be attached to a booking at all. An instructor with isBookable: false does not take one-on-one bookings, and a booking naming them is always rejected. Nothing overrides this, so filter on it before offering a coach for sale.
hourlyRate is added to the area’s price when 1Club prices the booking. A one hour court at 24 with a coach at 30 is priced at 54 unless you send an explicit payment.amount. See How the amount is calculated. clubId is the gym the instructor belongs to, or null when they work across the whole organization. maxConcurrentBookings is how many sessions the coach can run at once. Booking beyond it is a genuine conflict and is rejected.

​
Booking a coached session

1

Find the coach

Search by name with bookableOnly=true, so unbookable staff never reach your booking flow.
2

Check the slot

Read the area’s availability as usual. See Areas and availability.
3

Book with instructorId

Pass instructorId alongside areaId on Create a booking.
The coach’s own calendar is respected: a booking that would double-book them, or exceed maxConcurrentBookings, is rejected with a 409.
Attaching an instructor also feeds the gym’s instructor pay records automatically, so a coached booking you create is compensated the same way one booked in 1Club is. You do not need to report anything extra.