Integrate Kisi with USchedule

USchedule is a scheduling and business management platform for indoor golf facilities, golf simulators, sports training centers and other appointment-based businesses. Connect USchedule with Kisi to let customers unlock your door with a single tap from their reservation confirmation or appointments page. Access is available only during their reserved time, so you can offer unstaffed and after-hours bookings without handing out keys or codes.

info

This is a partner-built integration, maintained and supported by the partner.

Prerequisites

• Kisi organization administrator rights
• A Kisi API key belonging to a Kisi user who can unlock the doors you want customers to open. We recommend a dedicated user with access to those doors only. See Add users to create the user.
• A USchedule account with administrator access
• Door Access turned on for your USchedule account. USchedule turns this feature on: contact USchedule support to have it enabled. Until it's on, the Door Config option doesn't appear.

Generate a Kisi API key

You need to have organization administrator or organization owner rights to create an API key. We recommend creating API keys from the organization owner's account, to avoid the API key becoming invalid when an organization admin loses their admin rights.

1. Sign in to Kisi
2. On the top right corner, click on your name and click on My Account
3. Next, select the API tab and click on Add API Key
4. Enter the name for the API key and your Kisi password and click Add
5. Copy the API key shown on the screen and click Close

Create the API key while signed in as the dedicated user, so the key can only reach that user's doors.

Set up the integration in USchedule

tip

USchedule can complete this configuration for you. Send them your Kisi API key through a secure channel and tell them which doors belong to which simulator bays or rooms.

To configure it yourself, once Door Access is turned on for your account:

1. Sign in to USchedule as an administrator
2. Go to Settings > Locations and open the location the door belongs to. Door settings are saved per location, so repeat these steps for each location with Kisi doors.
3. Click Door Config
4. Set Door Vendor to Kisi
5. Paste your Kisi API key into API Key and click Find locks. USchedule lists every lock the key can access.
6. Click each door customers should be able to unlock. Each click adds the door to the Unlock Lock List, and the first one is also filled in as the Default Lock ID. Change the Default Lock ID if the main entrance is a different door.
7. Review the Begin Offset and End Offset. See Who can unlock, and when.
8. Click Unlock to send a test unlock to the default door and confirm it opens
9. Click Save

The Door Configuration window has these fields:

Field	What to enter
Door Vendor	Select Kisi. Saving under a different vendor replaces the location's existing door settings.
API Key	The Kisi API key for the user you created in Kisi. Once saved, it's never displayed again. Leave the field blank on later edits to keep the saved key.
Default Lock ID	The Kisi lock ID of the main entrance. It's used when the Unlock Lock List is empty.
Unlock Lock List	Every door customers may unlock, as a comma-separated list of lockId~Door Name, for example 74645~Entrance Door,74650~Bay Room. The name is what the customer sees on the button.
Begin Offset (minutes)	How many minutes before the reservation start time the door can be unlocked. Default: 15.
End Offset (minutes)	How many minutes after the reservation end time the door can still be unlocked. Default: 15.

Configure customer access

Who can unlock, and when

Access is based on reservations. A customer with an active reservation sees an Unlock Door button in their confirmation email and on their appointments page. When they tap it, USchedule checks the reservation and, if it's within the allowed window, sends the unlock command to Kisi. The customer doesn't need the Kisi app or a Kisi credential.

The allowed window runs from the Begin Offset before the reservation starts until the End Offset after it ends. For example, with the default 15-minute offsets, a 2:00 PM to 3:00 PM reservation can unlock the door from 1:45 PM to 3:15 PM. Outside that window, the customer sees a message that they're early or that the session has ended. Cancelled reservations can't unlock the door.

Multiple doors

If you list more than one door in the Unlock Lock List, the customer sees one button per door, labeled with the door name, for example Open Entrance Door. If the list is empty, the customer sees a single Open Door button for the default lock.

Assign a door to a resource

You can tie a door to a specific resource unit, such as one simulator bay, so that only customers who reserved that resource see its button. Doors without a resource assignment are shown to every customer.

To assign a door, add the resource unit ID as a third value in its list entry: lockId~Door Name~resourceUnitId. For example, 74650~Bay 3 Door~973 shows the Bay 3 Door button only to customers with a reservation for resource unit 973. Resource unit IDs are numeric values that USchedule support can look up and enter for you.

Staff access

Administrators can also unlock the door from the appointment details screen. You can use the Unlock button in Door Config to test the connection at any time.

Other important information

• Reservation-based access only - the integration doesn't sync memberships, and it doesn't create or change users, groups or access schedules in Kisi. USchedule uses Kisi's remote unlock for the doors your API key can reach.
• Changes and cancellations take effect immediately - USchedule checks the reservation each time the button is pressed, so rescheduling or cancelling needs no sync with Kisi. A moved reservation uses its new time, and a cancelled one stops unlocking.
• Reservations are marked as attended - when a customer unlocks the door for a reservation, USchedule marks the reservation as a show. All unlocks are recorded in the USchedule activity log.
• Connectivity - unlocking requires USchedule, Kisi and the lock to be online. If Kisi can't reach the lock, the customer sees an error.
• Require the app (optional) - USchedule can be configured so customers can only unlock from the USchedule app.
• Simulator power (optional) - if your account uses Kasa smart plugs, the unlock page also offers a Turn On Devices button to switch on simulators or screens.
• Smart PC Lock/Unlock - USchedule also offers Smart PC Lock/Unlock, which controls access to simulator computers based on reservation times. It works independently of the Kisi integration.
• Responsibility - facilities remain responsible for physical security, emergency access procedures and operational safeguards when running unattended.

Support

This is a partner-built integration, maintained and supported by USchedule. For USchedule configuration, reservations or help turning on Door Access, contact USchedule support. For Kisi hardware, lock configuration, users and API keys, contact our support team.