Integrate Kisi with SpaceBloom

SpaceBloom is a management platform for shared spaces, covering locations, member contracts, bookings and a member portal. Connect SpaceBloom with Kisi to give approved members door access at the locations their contracts cover, remove it when contracts end, and optionally grant access to bookable spaces only for the booked hours.

info

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

Prerequisites

• A Kisi organization with your locks set up, and an organization administrator account that will stay active
• A SpaceBloom organization with at least one location. The 30-day trial includes door access.
• Owner access in SpaceBloom. Only the organization's owner can connect Kisi or change its API key. Staff can map doors and approve members afterwards.
• No other event webhook on the Kisi organization. SpaceBloom registers its own event webhook for the door log and can't connect while another one exists.

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

The API key carries the permissions of the person who created it, and Kisi expires a key after six months of inactivity. Create it from an account that will stay with the organization.

Set up the integration in SpaceBloom

1. In your SpaceBloom dashboard, open the Access tab
2. Keep Kisi selected. It's the first option.
3. Paste the Kisi API key and click Connect

SpaceBloom stores the key encrypted and shows only its last four characters. It also registers its event webhook in your Kisi organization, so you don't need to set anything up in Kisi.

info

Kisi bills you for your places directly, so Kisi doors aren't added to your SpaceBloom subscription.

Map locks to locations

The Access tab lists the locks in your Kisi organization. Map each one to the SpaceBloom location it belongs to. For every mapped lock, SpaceBloom creates a Kisi group named SpaceBloom · <door>.

Each door has two switches, both off by default:

• Unlock from portal - members can open the door from the SpaceBloom portal on their phone. Every press is logged with their name. This suits an interior door better than a street entrance.
• Inside (exit) - marks a reader on the inside, so SpaceBloom records when people leave instead of estimating it. A push-to-exit button isn't a reader.

Give members access

A member qualifies for access when they have an active contract at a location with a mapped door. Nobody is enrolled automatically.

1. The member asks for door access from their SpaceBloom portal
2. Approve the request on the Access tab
3. SpaceBloom invites the member's email to your Kisi organization and adds them to that door's group. The invitation email comes from Kisi, so tell members to expect it.
4. The member signs in to the Kisi app with that email. The Kisi app is their credential.

Link members already in Kisi

The Access tab lists Kisi users who aren't linked to a SpaceBloom member yet under Already in your access system. Where an email matches one member, click Link. Otherwise, pick the member yourself. A linked user keeps their Kisi account and isn't invited again.

When access ends

Canceling a contract, or letting it run out, removes the member's Kisi access. SpaceBloom also re-checks everyone every night and removes any access that no longer applies. You can revoke access by hand at any time.

Grant access for each booking (optional)

For a space that members book by the hour, such as a shared kitchen, turn on Kisi access for each booking on its door on the Access tab. It's off by default.

Each booking then gets Kisi access to that door for the booked hours only, and the member opens it with the Kisi app. Canceling the booking, or a plan that stops, removes that access, and it ends with the booking in any case. The Schedule tab shows whether each booking's access has been issued.

What SpaceBloom changes in Kisi

In your Kisi organization	Created when	Removed when
A group SpaceBloom · <door> per mapped lock	You map the lock	You unmap the lock, or disconnect
A role assignment per member in that group	You approve the member	Their contract ends, you revoke, or you disconnect
An invitation to the member's email	You approve a member not yet in Kisi	Not removed. The Kisi user stays in your organization
One event webhook for the door log	You connect	You disconnect

note

Leave the SpaceBloom · groups to SpaceBloom and don't add people to them by hand, because SpaceBloom removes anyone whose contract has ended. Your locks, users and other groups are never changed.

Troubleshooting

Problem	What to do
Connect says a webhook already exists	SpaceBloom can't connect while another event webhook exists in your Kisi organization. Check what uses the existing webhook before you remove it, then connect again.
The Access tab says the webhook was switched off	Kisi turns off a webhook after repeated failed deliveries. Disconnect and connect again to restore the door log.
Doors stop loading, or access grants fail	Click Check key. If the key expired or its owner was removed, create a new API key and use Replace API key.
A member never received the invitation	The invitation comes from Kisi, not SpaceBloom. Ask the member to check their spam folder for a message from Kisi.

Disconnect SpaceBloom

Disconnecting removes every role assignment SpaceBloom made, deletes its event webhook and forgets the API key. Your members, locks and Kisi users stay as they are.

Support

This is a partner-built integration, maintained and supported by SpaceBloom. For help, contact chris.bluethman@parastride.com or see the SpaceBloom operator guide.