Skip to main content

Create a login

A login allows you to make authenticated requests to the Kisi API without having to enter your user credentials each time. Keep the login secret. Anyone who has the login can make requests on behalf of the user it belongs to.

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 your name, your Kisi password, and your verification code and click Add
  5. Copy the API key shown on the screen and click Close
info

In Kisi, the terms API key and login secret are used interchangeably. A user can have up to 40 logins. If there are more, Kisi expires them. Also, logins expire after six months of inactivity by default, unless expire: false is passed when creating them. In that case, they don't expire at all.

Manage multiple accounts for the same user​

If you intend to support multiple organization accounts for the same user, you will need to create a separate login for each of these accounts. It is not possible to fetch all organization accounts associated with a specific email address due to security reasons. Therefore, you must store the list of their organization IDs yourself.

On to the next step​

In the next step, you'll select the API endpoint.