Integrate Kisi with ClubOS
ClubOS, part of the ABC Fitness Solutions suite, is a member management platform for gyms and fitness clubs. It helps manage memberships, member engagement, check-ins, and more.
Our integration allows ClubOS clubs to synchronize member access automatically with their Kisi-controlled doors, so access reflects membership status. Kisi also records a check-in in ClubOS when a member unlocks a door at the club's entrance, and members can unlock with the barcode from the ClubOS app.
This is a Kisi-built integration, maintained and supported by Kisi.
Prerequisites
- Kisi organization administrator rights
- ClubOS admin rights
- Your ClubOS club ID
- The Kisi integration turned on for each club in ClubOS. Kisi can't read a club until the club turns on the integration
How the integration works
The ClubOS integration in Kisi has three tabs:
- Clubs - connect your ClubOS clubs and map each one to a Kisi place
- Configurations - choose the Kisi group that a club's active members get
- Check-In Locations - choose the doors and access points that record a check-in in ClubOS
Only one ClubOS integration is allowed per organization. You can connect several clubs and add several configurations within it.
Which members are synced
Kisi imports ClubOS users with the Member role. Prospects and other roles are not synced.
Kisi matches ClubOS members to Kisi users by email address (not case-sensitive). Members without a valid email address are skipped. Several ClubOS members with the same email address become one Kisi user, named after the member's first and last name.
If a member doesn't have a Kisi account yet, one is created when they first get access.
When access is granted and removed
Kisi follows the same rules ClubOS uses at the front desk. A member gets access to the configuration's group when all of these are true:
- The member is active in ClubOS
- The member's membership agreement is active
- The membership has started. The start date begins at midnight in the time zone of the club's Kisi place
- The member has no alert in ClubOS that blocks door access
Access is removed at the next sync when any of these is no longer true. For example, frozen, cancelled and expired members lose access. Members whose only blocking alert is Past Due can keep access for a while, see Grace period for past-due members.
If a member is removed from ClubOS, their access is removed at the next sync. If a member's email address changes in ClubOS, their access moves to the Kisi user with the new email address.
Sync schedule
ClubOS doesn't notify Kisi about changes, so Kisi runs a full sync of every club with a configuration every 30 minutes. You can see when each configuration last synced in the Last Synced column.
Adding, changing or deleting a configuration, and turning Sync Barcodes on or off, starts a sync of that club right away.
Turn on the Kisi integration in ClubOS
Before you can connect a club in Kisi, the club must turn on the Kisi integration in ClubOS. If you don't see the Kisi integration in your ClubOS account, contact your ClubOS account manager or ClubOS support and ask them to enable it for your club.
Note your ClubOS club ID. You need it to connect the club in Kisi.
Set up the integration in Kisi
Step 1: Add the integration
- Sign in to Kisi
- Click the integrations icon (3x3 grid of dots) > Add Integration
- Open the Type dropdown and select ClubOS
- Click Add
Step 2: Connect your clubs
- Click the Clubs tab
- Under ClubOS club ID, enter your club ID. The club ID contains only digits
- Click Connect Club. Kisi checks the club with ClubOS and adds it to the list
- Click the club in the list
- Under Place, select the Kisi place where the club is located
- (Optional) Turn on Sync Barcodes to give members their ClubOS app barcode as a Kisi credential. See Sync barcodes
- Click Save
Repeat these steps for each club. A club can be connected to only one Kisi organization.
You must map a club to a Kisi place before you can add a configuration for it. The club's configurations use the time zone of that place.
Step 3: Add a configuration
- Click the Configurations tab
- Click Add Configuration
- Under Select Club, select the club
- Select the Kisi group that the club's active members get
- Click Save
New configurations are always saved as enabled. Saving a configuration starts a sync of the club right away.
A club can have several configurations, one for each Kisi group. You can't add a second configuration for the same club and group.
Step 4: Add check-in locations
Add the doors and access points at each club's entrance as check-in locations. When a ClubOS member unlocks one, Kisi records a check-in in ClubOS. Unlocks anywhere else don't create a check-in.
- Click the Check-In Locations tab
- Click Add Location
- Under Select Club, select the club
- Select the Kisi place and the door or access point
- Click Add Location
Each door or access point can be added only once.
To use a standalone reader for check-ins without a door and controller, you need to first set up an access point in Kisi.
A check-in is recorded only when the member who unlocks is an active, synced member of that club. If several ClubOS members share the Kisi user's email address, one check-in is recorded for one of them.
Sync barcodes
With Sync Barcodes turned on for a club, Kisi gives each member with access the barcode from their ClubOS app as a third-party optical credential. Members can then unlock by scanning the barcode from the ClubOS app at the reader.
To turn barcode sync on or off:
- Click the Clubs tab
- Click the club
- Turn Sync Barcodes on or off
- Click Save
Syncing barcodes requires a Kisi Terminal Pro with the scanner module. Standard Kisi readers do not support optical scanning.
Members get their barcode at the next sync, not right away.
Grace period for past-due members
By default, members lose access at the next sync when ClubOS marks them Past Due. You can let past-due members keep their access for a number of days:
- Click Settings in the top-right corner
- Under Past Due grace period (days), enter the number of days. Enter 0 to remove access right away
- Click Save
The grace period applies only to members whose only blocking alert in ClubOS is Past Due. It keeps existing access but doesn't grant access to members who didn't already have it. Frozen, cancelled and expired members lose access at the next sync, whatever the grace period.
Manage configurations
Click a configuration on the Configurations tab to open it. You can turn the configuration on or off with the status switch and click Save.
The club, group and time zone are shown read-only. To use a different group, delete the configuration and create a new one.
To delete configurations, select them in the list and click Delete.
Turning a configuration off or deleting it removes the group access it granted at the next sync. If you delete the Kisi group used by a configuration, the configuration is deleted too.
Uninstall the integration
Removing the ClubOS integration deletes its clubs, configurations and check-in locations. It doesn't remove the Kisi users, group access or credentials the integration created. Remove them manually if you no longer need them.
Troubleshooting
A member doesn't have access
Check that the member:
- Has the Member role and is active in ClubOS
- Has a valid email address in ClubOS
- Has an active membership agreement that has already started
- Has no alert in ClubOS that blocks door access
Also check that the member's club is mapped to a Kisi place and has an enabled configuration. Changes in ClubOS can take up to 30 minutes to reach Kisi.
The Kisi integration was turned off in ClubOS
If a club turns off the Kisi integration in ClubOS, Kisi disables every configuration for that club and emails your organization administrators. Turn the integration back on in ClubOS, then turn the configurations back on in Kisi.
User limit reached
When your organization reaches its Kisi user limit, no new users are created and a banner shows "You have reached the maximum quota for the total number of users…". Members who already have a Kisi account are still synced. After raising the limit, click Reset in the banner to resume creating new users.
Error messages
| Message | What to do |
|---|---|
| Kisi can't access this club. Check the club ID, and make sure the club has turned on the Kisi integration in ClubOS. | Check the club ID. Turn on the Kisi integration in ClubOS |
| ClubOS has no club with this ID. Check the club ID and try again. | Check the club ID |
| This club is already connected to another Kisi organization. | Remove the club from the other organization's ClubOS integration, or contact our support team |
| Map the club to a Kisi place in the Clubs tab before adding a configuration. | Connect the club and map it to a place |
| Configuration already exists | The club and group already have a configuration. Open it from the Configurations tab |
| This door or access point is already mapped | Each door or access point can be added to only one check-in location |