@seshn/sdk

TypeScript SDK for the Seshn booking API — headless booking infrastructure for service businesses.

Install

npm install @seshn/sdk

Quickstart

import { Seshn } from "@seshn/sdk";

const seshn = new Seshn("sk_test_...", {
  baseUrl: "https://api.seshn.net",
});

// Check availability
const slots = await seshn.availability.list({
  serviceId: "svc_...",
  date: "2026-04-01",
});

// Book a slot
const booking = await seshn.bookings.create({
  serviceId: "svc_...",
  resourceId: "res_...",
  contactId: "con_...",
  startTime: "2026-04-01T10:00:00Z",
  endTime: "2026-04-01T11:00:00Z",
  seats: 1,
});

Resources

The SDK covers every Seshn API resource:

• seshn.availability — Check slot availability
• seshn.bookings — Create, update, cancel bookings
• seshn.bookingSeries — Manage recurring bookings
• seshn.contacts — Customer records
• seshn.services — Service types and configuration
• seshn.resources — Staff, rooms, equipment
• seshn.locations — Business locations
• seshn.payments — Stripe payment flows
• seshn.entitlements — Credit/package management
• seshn.waitlist — Waitlist with auto-promotion
• seshn.webhooks — Webhook endpoint management
• seshn.apiKeys — API key management
• seshn.auditLog — Activity audit trail
• seshn.users — User/team management
• seshn.organizations — Org setup

Sandbox mode

Use a sk_test_ key to work in sandbox mode — no real charges, seeded test data.

Docs

Full API documentation: seshn.net/docs

License

MIT