Webhooks
Webhooks allow you to receive real-time notifications when events occur in your Kisi organization. Instead of repeatedly polling the API to check for changes, webhooks push event data to your application as soon as something happens.
When you set up a webhook, you provide Kisi with a URL endpoint on your server. Kisi then sends HTTP POST requests to that URL whenever relevant events occur, including unlock events, user changes, access right modifications, and other activities. Your application receives the event data and can respond immediately, making webhooks essential for building responsive integrations, automated workflows, audit logs, and real-time monitoring systems.
What you can do
- Track unlocks using webhooks - Receive notifications whenever doors are unlocked and build audit logs or analytics
How it works
Webhooks follow this pattern:
- You configure a webhook with your server's URL endpoint
- Kisi sends HTTP POST requests to your endpoint when events occur
- Your application processes the event data (user, door, timestamp, etc.)
- You respond with a 200 status code to acknowledge receipt
Getting started
Before implementing webhooks, make sure you've completed the quick start guide to understand API authentication and basic request patterns. Then follow the track unlocks guide above to set up your first webhook and start receiving event notifications. Once you're comfortable with the basics, you can start building your own webhooks for any events that matter to your integration.