Booking
for developers

1import { Seshn } from '@seshn/sdk';
2
3const seshn = new Seshn('sk_live_...');
4
5const slots = await seshn.availability.query({
6  serviceId: 'svc_yoga_class',
7  from: '2026-03-15',
8  to: '2026-03-22',
9});
10
11const booking = await seshn.bookings.create({
12  slotId: slots[0].id,
13  contactId: 'ct_jane_doe',
14  seats: 2,
15});

1// 1. Create a held booking with payment
2const { booking, clientSecret } = await seshn.bookings.create({
3  slotId: slots[0].id,
4  contactId: 'ct_jane_doe',
5  seats: 2,
6  hold: true,
7  payment: { amount: 4000, currency: 'usd' },
8});
9
10// 2. Complete payment on the frontend with Stripe.js
11const stripe = Stripe('pk_live_...');
12await stripe.confirmPayment({ clientSecret });
13
14// 3. Seshn auto-confirms via Stripe webhook
15// booking.status → 'confirmed'

1const series = await seshn.bookingSeries.create({
2  contactId: 'ct_jane_doe',
3  serviceId: 'svc_yoga_class',
4  resourceId: 'res_studio_a',
5  seats: 1,
6  recurrence: {
7    frequency: 'weekly',
8    dayOfWeek: 2,    // Tuesday
9    time: '14:00',
10    count: 8,        // 8 weeks
11  },
12});
13
14// series.bookings → 8 confirmed bookings
15// Cancel just one: seshn.bookingSeries.cancelOccurrence(id, 3)