Skip to main content

Kisi

Availability
Available CoreAvailable StandardAvailable PlusAvailable ProAvailable Enterprise FlexAvailable PyAirbyte
Connector type (beta)
Available Data replicationNot available Agent(learn more)
Support Level
Marketplace
Connector Version
0.1.2 (last updated 4 days ago)
Data workers used
0.2 per sync (Learn more)
Definition ID
7706728b-f644-456e-8dd4-ac92c4d8f31a
info

Upgrading from 0.0.x? See the migration guide — the user_export_reporters stream was removed in 0.1.0.

This page contains the setup guide and reference information for the Kisi source connector. The connector reads data about your Kisi organization, such as users, places, locks, groups, and reports, from the Kisi API.

Prerequisites​

  • A Kisi account with organization administrator or organization owner rights. Kisi only allows these roles to create API keys.
  • A Kisi API key.

Setup guide​

Step 1: Generate a Kisi API key​

  1. Sign in to Kisi.
  2. In the top right corner, click your name, then click My Account.
  3. Select the API tab and click Add API Key.
  4. Enter a name for the API key and your Kisi password, then click Add.
  5. Copy the API key shown on the screen and click Close.

An API key is tied to the account that created it. If that account loses its admin rights, the key stops working. Kisi recommends creating API keys from the organization owner's account. For details, see Generate an API key in the Kisi documentation.

By default, Kisi expires API keys after 6 months of inactivity. A user can have up to 40 API keys, and Kisi expires keys beyond that limit. To create a key that doesn't expire, create it with the Kisi API's POST https://api.kisi.io/logins endpoint and set expire to false.

Step 2: Set up the Kisi connector in Airbyte​

  1. In Airbyte, go to Sources and click New source.
  2. Search for and select Kisi.
  3. In API Key, paste the API key from Step 1.
  4. Click Set up source.

The connector authenticates by sending the key in the Authorization: KISI-LOGIN <API key> header and tests the connection by reading the users endpoint.

Configuration​

InputTypeDescriptionDefault Value
api_keystringAPI Key. Your KISI API Key

Supported sync modes​

All streams support only full refresh syncs. The connector doesn't support incremental syncs.

Streams​

Stream NamePrimary KeyPaginationSupports Full SyncSupports Incremental
usersidDefaultPaginator✅❌
scheduled_reportsidDefaultPaginator✅❌
role_assignmentsidDefaultPaginator✅❌
placesidDefaultPaginator✅❌
reportsidDefaultPaginator✅❌
organizationsidDefaultPaginator✅❌
membersidDefaultPaginator✅❌
loginsidDefaultPaginator✅❌
locksidDefaultPaginator✅❌
groupsidDefaultPaginator✅❌
floorsidDefaultPaginator✅❌
elevatorsidDefaultPaginator✅❌

The floors and elevators streams are child streams of places. The connector reads all places first, then requests the floors and elevators for each place by its place_id.

Limitations​

Kisi limits authenticated API requests to 5 requests per second per user. All API keys that belong to the same Kisi user share this limit. When the limit is exceeded, Kisi returns an HTTP 429 response. For details, see the Kisi API documentation.

IP allow list​

If you use Airbyte Cloud and your organization restricts access to specific IPs, add the Airbyte Cloud IP addresses to your allow list.

Reference​

Config fields reference

Field
Type
Property name
string
api_key

Changelog​

Expand to review
VersionDatePull RequestSubject
0.1.22026-10-1388680Update dependencies
0.1.12026-10-0988404Mark api_key as airbyte_secret
0.1.02026-10-0988301Remove the user_export_reporters stream: Kisi removed the GET /user_export_reporters endpoint (HTTP 404)
0.0.732026-10-0687913Update dependencies
0.0.722026-09-2987218Update dependencies
0.0.712026-09-2286685Update dependencies
0.0.702026-09-1586104Update dependencies
0.0.692026-09-0885520Update dependencies
0.0.682026-08-1884633Update dependencies
0.0.672026-08-1183983Update dependencies
0.0.662026-08-0483513Update dependencies
0.0.652026-07-2882973Update dependencies
0.0.642026-07-2182470Update dependencies
0.0.632026-07-1481875Update dependencies
0.0.622026-06-3081127Update dependencies
0.0.612026-06-2380497Update dependencies
0.0.602026-06-1679899Update dependencies
0.0.592026-06-0979356Update dependencies
0.0.582026-06-0278773Update dependencies
0.0.572026-04-2877328Update dependencies
0.0.562026-04-2176639Update dependencies
0.0.552026-03-3175730Update dependencies
0.0.542026-03-2475029Update dependencies
0.0.532026-03-1074419Update dependencies
0.0.522026-03-0373956Update dependencies
0.0.512026-02-1773558Update dependencies
0.0.502026-02-1072766Update dependencies
0.0.492026-01-2072012Update dependencies
0.0.482026-01-1471492Update dependencies
0.0.472025-12-1870781Update dependencies
0.0.462025-11-2570037Update dependencies
0.0.452025-11-1869483Update dependencies
0.0.442025-10-2968758Update dependencies
0.0.432025-10-2168313Update dependencies
0.0.422025-10-1467960Update dependencies
0.0.412025-10-0767373Update dependencies
0.0.402025-09-3066786Update dependencies
0.0.392025-09-2466647Update dependencies
0.0.382025-09-0966079Update dependencies
0.0.372025-08-2365381Update dependencies
0.0.362025-08-0964615Update dependencies
0.0.352025-08-0264285Update dependencies
0.0.342025-07-2663900Update dependencies
0.0.332025-07-1963468Update dependencies
0.0.322025-07-1263150Update dependencies
0.0.312025-07-0562572Update dependencies
0.0.302025-06-2161783Update dependencies
0.0.292025-06-1461116Update dependencies
0.0.282025-05-2460636Update dependencies
0.0.272025-05-1059894Update dependencies
0.0.262025-05-0359256Update dependencies
0.0.252025-04-2658774Update dependencies
0.0.242025-04-1958159Update dependencies
0.0.232025-04-1257678Update dependencies
0.0.222025-04-0557109Update dependencies
0.0.212025-03-2956695Update dependencies
0.0.202025-03-2256007Update dependencies
0.0.192025-03-0855494Update dependencies
0.0.182025-03-0154811Update dependencies
0.0.172025-02-2254352Update dependencies
0.0.162025-02-1553865Update dependencies
0.0.152025-02-0853266Update dependencies
0.0.142025-02-0152771Update dependencies
0.0.132025-01-2552222Update dependencies
0.0.122025-01-1851786Update dependencies
0.0.112025-01-1151153Update dependencies
0.0.102024-12-2850636Update dependencies
0.0.92024-12-2150078Update dependencies
0.0.82024-12-1449627Update dependencies
0.0.72024-12-1249273Update dependencies
0.0.62024-12-1148983Starting with this version, the Docker image is now rootless. Please note that this and future versions will not be compatible with Airbyte versions earlier than 0.64
0.0.52024-11-0548356Revert to source-declarative-manifest v5.17.0
0.0.42024-11-0548332Update dependencies
0.0.32024-10-2947914Update dependencies
0.0.22024-10-2847606Update dependencies
0.0.12024-10-18Initial release by @aazam-gh via Connector Builder
Was this page helpful?