Skip to main content
POST
Create a booking

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

serviceId
string<uuid>
required

The service's id, from replo_booking_services_list

staffId
string<uuid>
required

The staff member's id, from the service's staff list

startsAt
string<date-time>
required

When the booking starts, such as a startsAt from replo_booking_slots_list; it may fall outside opening hours

contact
object
required

The person the booking is for; saved as a contact

seats
integer

People in the party; 1 if left out

Required range: 1 <= x <= 1000
addOnKeys
string[]

Add-ons the person wants, by key; each makes the booking longer. None if left out

Maximum array length: 20
Pattern: ^[a-z0-9][a-z0-9-]{0,63}$

Response

Create a booking

object
enum<string>
required
Available options:
booking
id
string<uuid>
required
projectId
string<uuid>
required
serviceId
string<uuid>
required
staffId
string<uuid>
required
responseId
string<uuid> | null
required

The form response the booking came with; null when added by hand

status
enum<string>
required

confirmed, cancelled, completed or no_show; held is a time a visitor is still filling in the form for

Available options:
held,
confirmed,
cancelled,
completed,
no_show
startsAt
string
required
endsAt
string
required
seats
integer
required
meetingUrl
string | null
required

The Google Meet link, if any

addOnKeys
string[]
required
contact
object | null
required

The person the booking is for

createdAt
string
required