Create a booking (not supported — use orders)
POST/v2/bookings
Requires your API key in the X-API-Key header.
Direct booking creation is intentionally not supported in v2. This endpoint
always returns a 400 with the message
"Bookings must be created through orders. Use POST /v2/booking-orders/".
To create bookings: create an order (POST /v2/booking-orders), add bookings to
it (each starts ON_HOLD with capacity reserved), then confirm the order to
transition them to ACCEPTED / PENDING.
curl -X POST "https://api.turneo.co/v2/bookings" \
-H "X-API-Key: <your-api-key>"Responses
Errors
- 400
Validation failed. Inspect
errors[].fieldanderrors[].code.- 401
Missing or invalid
X-API-Keyheader.- 403
The API key is valid but not allowed to perform this action on this resource.
Error body
typestringError class.
- Allowed values:
validation_errorclient_errorserver_error- Example:
validation_error
errorsobject[]Child fields
codestringMachine-readable error code.
- Example:
required
fieldstringnullableOffending field, or null/'general' for non-field errors.
- Example:
startTime
messagestringHuman-readable message.
- Example:
This field is required.
{
"type": "validation_error",
"errors": [
{
"code": "required",
"field": "startTime",
"message": "This field is required."
}
]
}