Reservation Services API
Define bookable services: duration, capacity, buffers, pricing, advance booking limits, confirmation behavior, and visibility. The Reservations settings UI creates and updates records through this API.
Base endpoint: /reservation-services
Service object (fields sent by the app)
json
| Field | Type | Description |
|---|---|---|
duration_minutes | Number | Length of one booking. |
buffer_before_minutes | Number | Extra time before each booking. |
buffer_after_minutes | Number | Extra time after each booking. |
slot_capacity | Number | How many parties can share the same slot. |
max_party_size | Number | Maximum people per reservation. |
slot_interval | Number | Minutes between slot start times. |
price | Number | null | Optional price. |
currency_id | Number | null | Organization currency ID (from organization currencies). |
max_advance_days | Number | How far ahead customers can book. |
min_advance_hours | Number | Minimum notice before first available slot. |
requires_confirmation | Boolean | If true, new bookings may start as pending. |
auto_confirm | Boolean | Auto-confirm when rules allow. |
allow_cancellation | Boolean | Whether cancellation is allowed. |
cancellation_deadline_hours | Number | Hours before start when cancellation closes. |
is_public | Boolean | Show on public booking flows when true. |
is_active | Boolean | Inactive services are hidden from normal selection. |
color | String | Hex color for UI. |
image_url | String | null | Optional image URL (upload via s3-url-signing type reservation-service-image or paste a URL). |
timezone | String | IANA timezone for interpreting local slot rules where applicable. |
Link resources to a service with Reservation service resources.
Report an issue with this documentation
Please log in to report issues with our documentation.