Skip to main content

Set up your Kisi account

Before you can start making API requests, you need to set up your Kisi account, create a place, and generate an API key. These are one-time setup steps that enable you to authenticate and interact with the Kisi API.

Prerequisites

To complete this setup, you need:

  1. A Kisi account - Create your account and sign in to access your organization
  2. A place - Create a place to represent your physical location (office, building, etc.)
  3. An API key - Generate an API key for authenticating your API requests
note

A user can have up to 40 API keys. If there are more, Kisi expires them. Also, API keys expire after 6 months of inactivity by default, unless expire: false is passed when creating them. In that case, they don't expire at all.

To set expire: false, you need to create the API key through the API's login endpoint (POST https://api.kisi.io/logins).

What you'll accomplish

After completing these three setup steps, you'll have:

  • Access to your Kisi organization through the web interface
  • A place configured to represent your physical space
  • An API key (login secret) to authenticate all subsequent API requests

On to the next step

Once you've completed your account setup, created a place, and generated your API key, you're ready to select the API endpoint for your first API call.