Start here

Getting started

Create a key, install an SDK and book your first slot.

1. Install the SDK

npm install @kestrel/sdk
# or
pip install kestrel-sdk

2. Create an API key

Open Settings → API keys and create a test key. Test keys start with ktl_test_ and never touch real data.

Keep it secret Never commit keys to source control. Load them from environment variables.

3. Make a request

import { Kestrel } from '@kestrel/sdk';

const kestrel = new Kestrel(process.env.KESTREL_KEY);

const slots = await kestrel.availability.list({
  calendar: 'cal_123',
  from: '2026-12-01',
  days: 7,
});

console.log(slots.length + ' open slots');

Next steps

Learn how authentication and scopes work.
Browse the API reference.
Add webhooks for booking events.