Getting Started

Quickstart

Go from zero to your first booking in under 5 minutes.

1. Create an account

Sign up at seshn.net/signup to get your test and live API keys.

2. Install the SDK

terminal
1npm install @seshn/sdk

3. Create a booking

Your test org comes pre-seeded with services, resources, and availability. Use your sk_test_ key to book immediately.

first-booking.ts
1import { Seshn } from '@seshn/sdk';
2
3const seshn = new Seshn('sk_test_...');
4
5// Check what's available
6const slots = await seshn.availability.query({
7  serviceId: 'svc_yoga_class',
8  from: '2026-03-20',
9  to: '2026-03-27',
10});
11
12console.log(`Found ${slots.data.length} available slots`);
13
14// Book the first available slot
15const { booking } = await seshn.bookings.create({
16  slotId: slots.data[0].id,
17  contactId: 'ct_jane_doe',
18  seats: 1,
19});
20
21// Confirm it
22await seshn.bookings.confirm(booking.id);
23console.log('Booking confirmed:', booking.id);

4. Check the dashboard

Open your dashboard to see the booking you just created. From here you can manage bookings, set up webhooks, and configure your API keys.

Framework guides

Step-by-step walkthroughs for integrating Seshn into your stack.

Next.js

Server Actions, App Router, and React Server Components.

TypeScript

Express

REST endpoints with webhook signature verification.

TypeScript

Python / FastAPI

Async endpoints using httpx for direct REST calls.

Python

Next steps