Skip to main content
POST
Create a booking service

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Replo-Api-Version
enum<string>
required

The public API version to use for this request.

Available options:
2026-11-10

Body

application/json
projectId
string<uuid>
required

The project that owns the forms, from list_projects

key
string
required

Stable identifier a form's booking question uses, such as mens-cut

Pattern: ^[a-z0-9][a-z0-9-]{0,119}$
name
string
required
Required string length: 1 - 255
durationMinutes
integer
required
Required range: 5 <= x <= 1440
description
string | null
Maximum string length: 2000
location
string | null

Street address or meeting link, shown to the visitor

Maximum string length: 1024
slotIntervalMinutes
integer

Minutes between start times offered to visitors

Required range: 5 <= x <= 1440
capacity
integer
Required range: 1 <= x <= 1000
bufferMinutes
integer

Free minutes kept after each booking

Required range: 0 <= x <= 720
minimumNoticeMinutes
integer

How soon before the start a visitor can still book

Required range: 0 <= x <= 43200
bookingWindowDays
integer

How far ahead visitors can book

Required range: 1 <= x <= 365
reminderHoursBefore
integer | null

Hours before the start to send a reminder; null sends none

Required range: 1 <= x <= 336
addOns
object[]

Extras a visitor can add, such as a beard trim

Maximum array length: 20

Adds a Google Meet link when the host has a calendar to write events to

Response

Create a booking service

object
enum<string>
required
Available options:
booking_service
id
string<uuid>
required
projectId
string<uuid>
required
key
string
required
name
string
required
description
string | null
required
location
string | null
required
durationMinutes
integer
required
slotIntervalMinutes
integer
required

Minutes between start times offered to visitors

capacity
integer
required

People one staff member or table takes at once

bufferMinutes
integer
required

Free minutes kept after each booking

minimumNoticeMinutes
integer
required

How soon before the start a visitor can still book

bookingWindowDays
integer
required

How far ahead visitors can book

reminderHoursBefore
integer | null
required

Hours before the start the reminder goes out; null sends none

addOns
object[]
required

Adds a Google Meet link when the staff member has a calendar to write events to

staff
object[]
required