Getting Started

Authentication

Seshn uses API keys to authenticate requests. Each organization gets a test key and a live key.

API Keys

Pass your API key in the Authorization header as a Bearer token.

request.sh

1curl https://api.seshn.net/v1/bookings \
2  -H "Authorization: Bearer sk_live_..."

Test vs Live keys

Prefix	Mode	Behavior
sk_test_	Sandbox	Seeded test data, mock payments, data resets monthly
sk_live_	Production	Real data, real Stripe charges, production webhooks

With the SDK

example.ts

1import { Seshn } from '@seshn/sdk';
2
3// Sandbox — no real charges
4const test = new Seshn('sk_test_...');
5
6// Production — real bookings and payments
7const live = new Seshn('sk_live_...');

Key management

You can create, rotate, and revoke API keys from the dashboard under API Keys. Each key can be scoped with RBAC permissions.