Smart Door Access with Kisi

What Kisi Does

Kisi is a smart access control system. When connected to Co-Desk, it automatically manages who can open which doors and when:

• Bookings — members get time-bound door access for the duration of their booking
• Plans / Subscriptions — members get ongoing access while their subscription is active
• Manual grants — admins can give any member access to any door, with optional start and end dates

Members can unlock doors from the My Keys page in the Member Portal, or via the Kisi mobile app.

Prerequisites

• An active Kisi account with your doors and groups already configured in the Kisi dashboard
• A Kisi API key created by the Organization Owner (admin-level keys may have limited permissions)

Step 1 — Connect Kisi

1. Go to Settings > Integrations
2. Click Add next to Kisi Access Control
3. Click the + button to assign it to your location(s)
4. Click Settings to open the configuration modal
5. Paste your Kisi API Key
6. Click Test Connection to verify the key works — you should see a green checkmark with your organization name
7. Click Save

If the test shows an error, check that your API key was created by the Organization Owner in Kisi's dashboard under Developer Settings.

Step 2 — Map Doors

Door mappings tell Co-Desk which Kisi doors or groups correspond to your spaces. There are two ways to set them up.

Option A: Sync from Kisi (recommended)

1. Navigate to Door Mappings from the admin sidebar
2. Click the Sync from Provider action (top of the list)
3. Co-Desk pulls all doors and groups from your Kisi account and creates mappings automatically
4. Review the synced mappings and assign each one to the correct Location and Space (for locks)

Option B: Create manually

1. Navigate to Door Mappings and click Create Door Mapping
2. Fill in:
   • Location — which location this door belongs to
   • Resource Type — Lock (Door) for a single door, or Group for a Kisi door group
   • Space — the Co-Desk space this door protects (only required for Locks; Groups apply to the whole location)
   • Provider Resource — select the door or group from the dropdown (pulled live from Kisi)
   • Provider Resource Name — auto-filled, or enter a friendly name
3. Save

Locks vs Groups

• A Lock is a single physical door. Map it to a specific space (e.g., "Meeting Room 1 Lock" mapped to the Meeting Room 1 space).
• A Group is a collection of doors in Kisi (e.g., "Common Areas" containing the main entrance, kitchen, and bathroom). Map it to a location — all members at that location with an active booking or plan get access to the entire group.

You can use the Test Connection action (wifi icon) on any door mapping to verify it is reachable in Kisi.

Step 3 — Assign Door Access to Plans

You can configure which doors a plan grants access to. When a member purchases that plan, they automatically get access.

1. Go to the Plan detail page
2. Click the Door Access tab
3. Click the Add Door Access action
4. Select the door mapping from the dropdown
5. Save

When a member subscribes to this plan, they receive door access automatically. When their subscription ends, access is revoked.

Step 4 — Grant Manual Access to Members

Admins can grant door access to any member independently of bookings or plans.

1. Go to the Member detail page
2. Click the Door Access tab
3. Click the Grant Door Access action (lock icon in the toolbar)
4. Select a door or group from the dropdown
5. Optionally set Starts At and Ends At dates (leave blank for immediate, indefinite access)
6. Click Grant Access

The member will see the door in their My Keys page immediately.

To revoke, click the Revoke action (X icon) next to the access record. To restore a revoked grant, click Restore.

How Access Is Granted

Source	When	Duration
Booking	Automatically when a booking is confirmed	Time-bound (booking start to end)
Plan / Subscription	Automatically when a membership is created	Until subscription ends (or indefinite)
Manual	When an admin grants access via the Door Access tab	Custom start/end dates, or indefinite

All access records appear in the Door Access tab on the member's detail page, with badges showing the source (Booking, Plan, Manual) and status (Active, Revoked, Expired).

How Access Is Revoked

• Bookings — access is automatically revoked when the booking period ends
• Subscriptions — access is revoked when the subscription is cancelled or expires
• Manual grants — admin clicks Revoke on the member's Door Access tab
• Scheduled expiry — an hourly background job automatically expires grants that have passed their end date

If booking or subscription dates are updated, the access window in Kisi is automatically updated to match the new dates.

Member Portal — My Keys

Members can unlock doors directly from the My Keys page in their Member Portal.

• The page shows a flat list of all doors the member can currently access, regardless of source
• Groups are expanded into individual doors, so the member sees actual door names
• Each door has an Unlock button — tap to unlock the door remotely
• The info tip reminds members to be near the door when tapping

Members can also use the Kisi mobile app for NFC or Bluetooth unlock if configured.

Troubleshooting Access Issues

Member says they cannot get in:

1. Go to the member's detail page and check the Door Access tab — is there an active record for the correct door?
2. Check that the door mapping exists and is assigned to the correct space/location
3. Check the Access Logs tab on the door mapping for any failed grant attempts
4. Verify the member's booking or subscription is in a confirmed/active state
5. In the Kisi dashboard, check the member's credentials under Digital Credentials

Access was not revoked after booking ended:

1. Check the member's Door Access tab — the record should show status "Expired" or "Revoked"
2. If it still shows "Active", you can manually revoke it from the Door Access tab
3. As a fallback, revoke directly in the Kisi dashboard

Sync from Provider shows no results:

Verify your API key has permission to list locks and groups. Test the connection in Settings > Integrations > Kisi > Settings > Test Connection.

Removing the Kisi Integration

Go to Settings > Integrations, find Kisi Access Control, and click Remove. This removes the API connection. Door mappings remain saved but are inactive until you reconnect.

---

Common Questions

What is the difference between a Lock and a Group? A Lock is a single door. A Group is a collection of doors configured in Kisi. If you want to give a member access to multiple doors at once (e.g., all common areas), use a Group.

Do members need to install the Kisi app? Members can unlock doors from the My Keys page in the Co-Desk Member Portal without the Kisi app. However, the Kisi app provides additional features like NFC and Bluetooth unlock, and works when the member is offline.

Can I give a member access without a booking or plan? Yes — use the Grant Door Access action on the member's detail page. You can set custom start/end dates or leave them blank for indefinite access.

Does Kisi work for coliving rooms? Yes — map the room or building entrance to the relevant Kisi door group just as you would for coworking spaces.

What happens if order dates change? Co-Desk automatically updates the access window in Kisi when booking or subscription dates are modified.

What happens if Kisi is down? Co-Desk bookings are not affected. Door unlock via the Member Portal or Kisi app may be unavailable. You will need to grant manual access in the meantime.

Can I see who opened which door? Access logs are available on each door mapping's detail page under the Access Logs tab, showing the member, action, status, and timestamp for every grant and revoke operation.