Quick start

Welcome! Our quick start guides will walk you through a complete example of integrating with the Kisi API. You'll learn how to authenticate, structure requests, and handle responses by following a hands-on tutorial that creates a new door (lock) in your Kisi organization.

By the end of this quick start, you'll have:

• Set up your Kisi account and created a place (physical location)
• Generated an API key for authentication
• Made your first authenticated API request to create a lock
• Learned proper error handling and retry strategies

The five steps

1. Set up your Kisi account - Create your account, place, and API key to get started
2. Select the API endpoint - Choose the Locks endpoint to create a new door
3. Add necessary headers - Configure authentication, content type, and accept headers
4. Make your first API call - Send a POST request to create a lock with a name and place ID
5. Error handling - Understand HTTP status codes, rate limiting, and retry strategies

Beyond this example

This quick start uses the locks endpoint to create a door, but the same authentication, header configuration, and error handling patterns apply to all API endpoints. Once you complete this tutorial, you can apply the same logic with different endpoints and payloads to accomplish any integration task.

The core pattern remains the same:

• Authenticate with your API key
• Add the required headers
• Send properly formatted JSON payloads
• Handle responses appropriately

For a complete list of available endpoints and resources, see the Kisi API reference.