Raw schema
{
"type": "object",
"properties": {
"productId": {
"type": "string",
"description": "Product id (see bookeo_list_products)."
},
"eventId": {
"description": "Slot id from bookeo_get_availability_slots / bookeo_search_matching_slots. REQUIRED for fixed and fixedCourse products; optional for flexibleTime (use startTime instead).",
"type": "string"
},
"startTime": {
"type": "string",
"description": "Start time, for flexibleTime products when no eventId is given β RFC 3339 date-time, e.g. 2026-10-01T09:00:00-04:00. The offset -00:00 means the account's local timezone."
},
"endTime": {
"type": "string",
"description": "Optional forced end time for flexibleTime products (otherwise Bookeo computes the duration) β RFC 3339 date-time, e.g. 2026-10-01T09:00:00-04:00. The offset -00:00 means the account's local timezone."
},
"customerId": {
"description": "Id of an EXISTING customer (see bookeo_list_customers).",
"type": "string"
},
"customer": {
"description": "A NEW customer to create together with the booking. Use customerId instead for an existing customer.",
"type": "object",
"properties": {
"firstName": {
"type": "string"
},
"lastName": {
"type": "string"
},
"emailAddress": {
"type": "string"
},
"phoneNumbers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"number": {
"type": "string"
},
"type": {
"type": "string",
"enum": [
"mobile",
"work",
"home",
"fax"
]
}
},
"required": [
"number",
"type"
]
}
},
"streetAddress": {
"type": "object",
"properties": {
"address1": {
"type": "string"
},
"address2": {
"type": "string"
},
"city": {
"type": "string"
},
"state": {
"type": "string"
},
"postcode": {
"type": "string"
},
"countryCode": {
"description": "ISO 3166-1 alpha-2, e.g. US.",
"type": "string"
}
}
}
},
"required": [
"firstName",
"lastName"
]
},
"peopleNumbers": {
"minItems": 1,
"type": "array",
"items": {
"type": "object",
"properties": {
"peopleCategoryId": {
"type": "string",
"description": "People category id, e.g. Cadults, Cchildren, Cinfants or a custom id (see bookeo_list_people_categories)."
},
"number": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "How many people of this category."
}
},
"required": [
"peopleCategoryId",
"number"
]
},
"description": "Participant counts per people category."
},
"options": {
"description": "Product options (see bookeo_list_products).",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"description": "Option id (from the product's choice/number/onOff/textOptions).",
"type": "string"
},
"name": {
"description": "Option name, as an alternative to id.",
"type": "string"
},
"value": {
"type": "string",
"description": "Option value: \"true\"/\"false\" for on/off options, a number as a string, the chosen value's name, or free text."
}
},
"required": [
"value"
]
}
},
"resources": {
"description": "Resources (e.g. a specific guide or instructor) β for flexibleTime products.",
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Resource id (see bookeo_list_resources)."
}
},
"required": [
"id"
]
}
},
"externalRef": {
"description": "Your own reference for this booking (max 64 chars).",
"type": "string",
"maxLength": 64
},
"promotionCodeInput": {
"description": "Promotion code(s), comma-separated.",
"type": "string"
},
"privateEvent": {
"description": "Reserve the entire event, if the product allows it.",
"type": "boolean"
},
"previousHoldId": {
"description": "Hold id from bookeo_create_hold; it is released on success.",
"type": "string"
},
"notifyUsers": {
"description": "Email/SMS the business's staff.",
"type": "boolean"
},
"notifyCustomer": {
"description": "Send the customer a confirmation email.",
"type": "boolean"
},
"sendCustomerReminders": {
"description": "Send the customer reminders before the booking.",
"type": "boolean"
},
"sendCustomerThankyou": {
"description": "Send the customer a thank-you after the booking.",
"type": "boolean"
},
"mode": {
"description": "Set to \"backend\" to act as a manager, relaxing customer-facing limits (time in advance, participant limits, change windows).",
"type": "string",
"enum": [
"backend"
]
}
},
"required": [
"productId",
"peopleNumbers"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}