---
title: "Integrating Kisi"
slug: "integrating-kisi"
updated: 2024-02-23T16:52:32Z
published: 2024-02-23T16:52:32Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.nexudus.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrating Kisi

## What You Need to Integrate Kisi

You need to make sure some requirements are met before you can integrate Kisi with Nexudus.

### A Kisi Account

If you don't have a Kisi account yet, we encourage you to get in touch with the Kisi team who will help you create your account and install the system in your space.

### Resources and Passes in Nexudus

You need inventory items set up in your Nexudus account to use the Kisi integration. You can choose to connect all your resources and passes to Kisi or only some of them.

### Access Groups in Kisi

You need to set up access groups in your Kisi account. These groups will then be linked to passes and resources in Nexudus.

          Access groups can only be created and edited in Kisi.

          

Consider the following points before creating access groups in Kisi:

- **How many access groups you need to create**

We recommend you create one access group per pass and per resource you have in your Nexudus inventory.

*For example, if you have 4 passes and 8 resources in your inventory, you need to create 12 access groups in Kisi.*

- **Which doors customers need to access**

When creating an access group, think about all the doors your customers will need to unlock in order to access a specific resource or area of your building.

*For example, customers booking a resource need access to the resource door as well as any other door they need to unlock to get to the resource, such as the main entrance door or a floor door.*

Once you've figured out how many Kisi groups you need and which doors each of them should include, check out Kisi's article on how to set up an access group. You only need to create access groups in Kisi. Nexudus will automatically add users to the Kisi groups when they purchase passes or book resources.

### A Kisi API Token

You need to create an API token in Kisi to allow Nexudus and Kisi to communicate and grant your customers access.

1. Go to [web.kisi.io/users/sign_in](https://web.kisi.io/users/sign_in).
2. Sign in to your Kisi account.
3. Click on your name in the top right corner of the page.
4. Select **API** in the drop-down menu.
5. Click **Add API Key**.
6. Name API key **Nexudus** or **Nexudus Access**.
7. Enter your Kisi password in the **Password** field.
8. Click **Add**.
9. Copy the **API token** displayed on the screen and save it somewhere.

*You'll need to add this API token in Nexudus during Step 1 of the integration process.*

          Treat your API token as you would any password.

          

Save it somewhere safe and don't share it with anyone.

## Integrating Kisi

Integrating Kisi is an easy two-step process.

### Step 1. Enabling Kisi

Once you've set up your Kisi access groups, you can link them to your Nexudus passes and resources to finalize the integration.

1. Log in to [dashboard.nexudus.com](https://dashboard.nexudus.com/) if you aren't already.
2. Click [**Settings > Integrations > Kisi**](https://dashboard.nexudus.com/settings/integrations/kisi).
3. Enable the **Kisi integration** toggle.
4. Add your **Kisi API token**.
5. Select a **No access policy**.

          
          

**Suspend Kisi user account** Users are automatically suspended if they don't have connected passes, bookings or contracts with connected desks and offices in their account. **Delete Kisi user account** Users are automatically deleted if they don't have connected passes, bookings or contracts with connected desks and offices in their account.

1. Click the **Save Changes** button.

### Step 2. Linking Kisi Access Groups to Your Nexudus Inventory

After clicking on **Save Changes**, the **Resources** and **Passes** sections will appear below the initial form to let you link Kisi access groups to your resources and passes.

#### Resources

Select the Kisi access group that corresponds to each resource. You can leave the field empty if you don't want to connect a resource to Kisi.

![Kisi_Resources.png](https://cdn.document360.io/4f9a66c7-3dbb-4052-97d8-5439302e1512/Images/Documentation/Kisi_Resources.png)

Customers are automatically added to the relevant Kisi access group 15 minutes before the start of their bookings. They are also automatically removed from the relevant Kisi access groups 15 minutes after their booking ends.

#### Passes

Select the Kisi access group that corresponds to each pass. You can leave the field empty if you don't want to connect a pass to Kisi.

![Kisi_Passes.png](https://cdn.document360.io/4f9a66c7-3dbb-4052-97d8-5439302e1512/Images/Documentation/Kisi_Passes.png)

Customers are automatically added to the relevant Kisi access groups as long as they have valid time or day passes connected to Kisi access groups in their account. They are removed from the relevant Kisi access groups shortly after they run out of valid passes.

All set! Kisi is now integrated with Nexudus and your customers should be able to unlock doors through Kisi based on their bookings and the passes they hold.