Creates a booking for the given staff member(s), customer(s), and service(s).
What you are booking. It must match the type of the service in service_id:
APPOINTMENT: a one-to-one booking of a service (a service whosetypeisSERVICE).SESSION: a place in a group class (a service whosetypeisCLASS). A session holds from 0 up to 50 customers, and never more than the number of seats the class offers (themax_seatsof its service).
If it does not match, the request is rejected with 400 parameter_invalid.
Ids of the customers attending this booking.
- Appointment: send exactly 1 customer.
- Session (group class): from 0 up to the number of seats the class offers (the
max_seatsof its service). To add or remove someone later, use Add a customer to a class session or Remove a customer from a class session.
Any other number of customers is rejected with 400 out_of_range.
[ "cust_123456" ]
Id of the service or class being booked. Its type must match the booking type (SERVICE for an APPOINTMENT, CLASS for a SESSION).
Start date/time, an RFC 3339 date-time with an offset: Z for UTC or a numeric offset such as +08:00, in whole seconds. For example, 2026-11-19T08:30:00+08:00 and 2026-11-19T00:30:00Z are the same moment. It is returned in UTC.
End date/time, an RFC 3339 date-time with an offset: Z for UTC or a numeric offset such as +08:00, in whole seconds. For example, 2026-11-19T09:00:00+08:00 and 2026-11-19T01:00:00Z are the same moment. It is returned in UTC.
Cost of the appointment. Defaults to 0 when not provided.
Title of the booking. Defaults to an empty string when not provided.
Notes about the booking. Defaults to an empty string when not provided.
Free-text label for the booking, e.g. a status or reminder tag such as RUNNING_LATE or NO_SHOW. Defaults to an empty string when not provided.
Video meeting for the booking. Providing the provider type is enough, and the link is generated for you.
- Production serverhttps://developer.setmore.com/api/v2/bookings
curl -i -X POST \
https://developer.setmore.com/api/v2/bookings \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'Content-Type: application/json' \
-d '{
"id": "bk_123456",
"type": "APPOINTMENT",
"account_id": "acc_123456",
"provider_id": "provider_123456",
"consumer_ids": [
"cust_123456"
],
"service_id": "svc_123456",
"start_at": "2026-11-19T08:30:00+08:00",
"end_at": "2026-11-19T09:00:00+08:00",
"cost": 50,
"title": "Consultation",
"notes": "Customer requested a reminder call the day before.",
"label": "RUNNING_LATE",
"location": {
"type": [
"videoType"
],
"video_type": [
{
"type": "google-meet"
}
]
},
"source": "booking_page",
"meta_data": {
"referred_by": "google_ads"
}
}'{ "data": { "id": "bk_123456", "type": "APPOINTMENT", "calendar_id": "cal_123456", "account_id": "acc_123456", "provider_id": "provider_123456", "consumer_ids": [ … ], "service_id": "svc_123456", "start_at": "2026-01-20T09:00:00Z", "end_at": "2026-01-20T10:00:00Z", "status": "CONFIRMED" } }