Kisi (beta) Integration

This document applies to: Coworking & Workplace

Proximity now integrates with Kisi access control. This integration allows space owners and managers to leverage Kisi hardware with the Proximity software platform. Door schedules, access, user groups and users can be managed from the Proximity platform and kept in sync with Kisi. Members of the Proximity platform will use the Proximity mobile or web apps to unlock doors when access is granted via their membership type, resource reservation or directly granted to the member. This integration is seamless for your members. No new service to register for, simply use the Proximity mobile or web apps the same way they always have been.

If you have Kisi:

Proximity's integration works directly with Kisi hardware via the cloud. To use this integration, you'll need to reach out to Support via the chat bubble or via email to hello@beinproximity.com. If you have Kisi hardware, you do not need a Proximity door controller.

If you do not have Kisi locks:

Feel free to contact Support and we'd be happy to connect you to an authorized Kisi dealer in your area

Integration Features:

The Kisi + Proximity integration allows you to:

  • Display digital keys via the Proximity iOS and Android mobile apps or web app to allow members to unlock doors at your space.
  • Assign access permissions to membership types, individual members and resources.
  • Offer 24/7 or granular access schedules for each membership type.
  • Access granted via membership types will be instantly revoked if your member fails to renew their membership, no management intervention needed!
  • Enable access with reservations at your space 15 minutes before the members reservation begins. Access will be automatically revoked 15 minutes after the reservation ends.
  • Record a check-in and door log when anyone unlocks a door to your space via the Proximity mobile or web apps.
  • When the integration is connected any existing users in your Kisi dashboard will be merged with your members in Proximity if their email address matches so you don't have to worry about managing duplicates.

Connect the Kisi Integration

In Kisi:

These steps will be completed before connecting the integration to Proximity. Your space will need to grant access to a single user in Kisi that will then be used to connect the integration to your Proximity site. Proximity recommends creating a generic administrator in Kisi to prevent integration issues when management turnover occurs. Creating a generic administrator with an email like proximityapi@yourcompany.com would work. The following steps assume you already have your Kisi dashboard set up with your Kisi hardware and have created a generic administrator.

  1. While logged into the Kisi dashboard as the generic administrator you created navigate to "My Account" -> "API".
  2. Create a new API key and name it "Proximity Integration"
  3. Once the API key is created copy the value. You will need this later in the setup.

In Proximity:

During our Beta period, a Proximity Support Technician will connect the integration for you. Contact Proximity support via the chat bubble or email hello@beinproximity.com and provide your API key when asked.

Configure Kisi in Proximity

Once the integration is connected you and your members can immediately start unlocking your doors via the Proximity mobile or web apps.

Door Schedules

The Proximity platform will create door schedules in Kisi that you can view and verify the integration is working correctly. Please don't edit these schedules in Kisi as the changes will not be reflected in the Proximity platform. Any changes made in Kisi will also be overwritten the next time a change is made in the Proximity platform.

To adjust door unlock schedules navigate to "Manage Doors" > "Schedules".

  1. Click "Edit Membership Schedule and Access" for the door you want to adjust
  2. Be sure the "Schedule" tab is selected
  3. Use the slider to adjust the unlock schedule for the selected door
  4. Repeat for all doors

Door Access Schedules for Membership Types

The Proximity platform will create a "User Group" in Kisi for each Membership Type / Door combination in the Proximity platform. The Proximity platform will also create an access schedule and attach it to each "User Group" in Kisi. When a member in the Proximity platform is granted access via their Membership Type the Proximity platform will automatically move these Users in and out of the appropriate User Groups in Kisi. You can view these User Groups in Kisi to verify the integration is working but please don't manually move Users in and out of these User Groups or make changes to the access schedules as these changes will not be reflected in the Proximity platform and can cause resources to get out of sync.

To adjust access schedules for your membership types navigate to "Manage Doors" > "Schedules".

  1. Click "Edit Membership Schedule and Access" for the door you want to adjust
  2. Be sure the "Membership Access" tab is selected
  3. Click the membership type you want to grant access to and use the slider to set the access schedule
  4. Repeat for each membership type and door you want to grant access to

Door Access for Reservations

The Proximity platform will create a "User Group" for each Resource / Door combination in the Proximity platform. The Proximity platform will also create an access schedule and attach it to each "User Group" in Kisi. When a member creates a reservation in a resource the Proximity platform will automatically move that User into the User Group 15 minutes before the reservation starts. 15 minutes after the reservation ends the Proximity platform will remove that User from the User Group revoking access. You can view these User Groups in Kisi to verify the integration is working but please don't manually move Users in and out of these User Groups or make changes to the access schedules as these changes will not be reflected in the Proximity platform and can cause resources to get out of sync.

To give door access with a reservation, navigate from the dashboard to "Manage Reservations" > "Reservable Resources" and select the reservable resource which you'd like to add door access to. Scroll down to "Doors" and select the doors that the member reserving the resource would have access to. 

Keep in mind that only the person making the reservation will have door access. Access to the door will be granted 15 minutes before and revoked 15 minutes after their reservation. If they end their reservation early, door access will only be available 15 minutes after the end time. Likewise, if they extend their reservation, door access will be extended.

Note: If a reservation is created that has a start time in the past in can take up to a minute for keys to be provisioned that grant access for the reservation.

Directly Assigned Door Access

The Proximity platform will create a "User Group" in Kisi for each Member / Door combination in the Proximity platform. The Proximity platform will also create an access schedule and attach it to each "User Group" in Kisi. You can view these User Groups in Kisi to verify the integration is working but please don't manually move Users in and out of these User Groups or make changes to the access schedules as these changes will not be reflected in the Proximity platform and can cause resources to get out of sync.

To directly assign access to a door for a member edit the member and click the "Keys" tab. Choose the door you want to grant access to from the drop down.

Note: Doors directly assigned to a member will never be revoked unless done so by a manager. This means if a member is downgraded for a missed payment or other reason they will still retain access to the door(s) directly assigned to them. In most cases assigning access via a membership type is a better way of assigning access because the Proximity platform will automatically revoke access when necessary.

Known Issues:

  1. Proximity will automatically create the appropriate users in Kisi if they do not exist. When a user is created in Kisi by Proximity the Proximity platform will automatically verify that users email in Kisi. If a user is manually created in Kisi and then connected to the Proximity platform that user will need to verify their email in Kisi. This is not the recommended flow since it creates additional steps the user must take to get access to keys. The integration is designed to be invisible to the end user. Letting the Proximity platform do the work is the desired flow.
  2. If a users email is changed in either the Proximity platform or in Kisi the integration will stop working for this user. We are currently working on a way to handle this scenario.
  3. While in beta the Kisi integration can not be disconnected. If you wish to disconnect the Kisi integration please reach out to Proximity Support.
  4. Kisi hardware does not currently support PIN code functionality