Skip to main content
POST
Create a Booking

Authorizations

Authorization
string
header
required

A sandbox or production secret key.

Headers

Idempotency-Key
string
required

A caller-owned key for safely retrying one write.

Required string length: 8 - 255

Body

application/json
practitioner_id
string
required
Maximum string length: 100
Pattern: ^prc_[A-Za-z0-9_-]+$
starts_at
string<date-time>
required
ends_at
string<date-time>
required
format
enum<string>
required
Available options:
online,
in_person,
phone
payment_source
enum<string>
required
Available options:
self_pay,
covered

Response

The idempotent Booking was returned

id
string
required
Maximum string length: 100
Pattern: ^bkg_[A-Za-z0-9_-]+$
object
string
required
Allowed value: "booking"
session_id
string
required
Maximum string length: 100
Pattern: ^ses_[A-Za-z0-9_-]+$
practitioner_id
string
required
Maximum string length: 100
Pattern: ^prc_[A-Za-z0-9_-]+$
starts_at
string<date-time>
required
ends_at
string<date-time>
required
timezone
string
required
format
enum<string>
required
Available options:
online,
in_person,
phone
status
enum<string>
required
Available options:
reserved,
confirmed,
cancelled
payment_source
enum<string>
required
Available options:
self_pay,
covered
Last modified on July 30, 2026