Send an enquiry
const url = 'https://example.kwickbooking.com/public/v1/booking-enquiries';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"venueId":null,"name":"Alex Brown","phone":"07911 123456","email":null,"subject":"Private hire for 40","message":"We\'d like the upstairs room on a Saturday in November.","bookingReference":null,"guestType":null}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://example.kwickbooking.com/public/v1/booking-enquiries \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "venueId": null, "name": "Alex Brown", "phone": "07911 123456", "email": null, "subject": "Private hire for 40", "message": "We'\''d like the upstairs room on a Saturday in November.", "bookingReference": null, "guestType": null }'Passes an enquiry to the venue’s team, for example a large party, private hire, a special request, or a guest who wants none of the times offered. Needs the guest’s name and a phone number or email. With a booking reference and the phone on that booking, the enquiry is attached to the booking. Send an Idempotency-Key header.
Authorizations
Section titled “Authorizations”Request Bodyrequired
Section titled “Request Bodyrequired”POST /public/v1/booking-enquiries: an enquiry for the venue’s team (large parties,
private hire, special requests). With BookingReference and the phone on
that booking it is attached to the booking. A phone or an email is needed to reply.
object
Example
{ "venueId": null, "name": "Alex Brown", "phone": "07911 123456", "email": null, "subject": "Private hire for 40", "message": "We'd like the upstairs room on a Saturday in November.", "bookingReference": null, "guestType": null}Responses
Section titled “Responses”Created
The enquiry raised, with a summary to read out.
object
Example
{ "enquiryId": "01920000-0000-7000-8000-000000000008", "venueId": "01920000-0000-7000-8000-000000000001", "summary": "Thanks, I've passed your enquiry to Soho. They'll be in touch."}Venue required (https://developers.kwickblocks.ai/problems/venue-required); Validation failed (https://developers.kwickblocks.ai/problems/validation-failed); Idempotency-Key required (https://developers.kwickblocks.ai/problems/idempotency-key-required)
RFC 9457 problem details. type is a URI with a page describing the problem.
object
Safe to read to a guest.
A machine-readable code on the widget’s routes.
Examples
Venue required
{ "type": "https://developers.kwickblocks.ai/problems/venue-required", "title": "Venue required", "status": 400, "detail": "Please say which venue this is for."}Validation failed
{ "type": "https://developers.kwickblocks.ai/problems/validation-failed", "title": "Validation failed", "status": 400, "detail": "Some of the details weren't valid. Please check them and try again."}Idempotency-Key required
{ "type": "https://developers.kwickblocks.ai/problems/idempotency-key-required", "title": "Idempotency-Key required", "status": 400, "detail": "This request needs an Idempotency-Key header."}Invalid or missing integration key (https://developers.kwickblocks.ai/problems/invalid-key)
RFC 9457 problem details. type is a URI with a page describing the problem.
object
Safe to read to a guest.
A machine-readable code on the widget’s routes.
Examples
Invalid or missing integration key
{ "type": "https://developers.kwickblocks.ai/problems/invalid-key", "title": "Invalid or missing integration key", "status": 401, "detail": "This integration key isn't valid. Ask the venue's admin for a new one."}Capability not granted (https://developers.kwickblocks.ai/problems/capability-missing)
RFC 9457 problem details. type is a URI with a page describing the problem.
object
Safe to read to a guest.
A machine-readable code on the widget’s routes.
Examples
Capability not granted
{ "type": "https://developers.kwickblocks.ai/problems/capability-missing", "title": "Capability not granted", "status": 403, "detail": "This integration key isn't allowed to do that. Ask the venue's admin to add the capability."}Venue not found (https://developers.kwickblocks.ai/problems/venue-not-found); Booking not found (https://developers.kwickblocks.ai/problems/booking-not-found)
RFC 9457 problem details. type is a URI with a page describing the problem.
object
Safe to read to a guest.
A machine-readable code on the widget’s routes.
Examples
Venue not found
{ "type": "https://developers.kwickblocks.ai/problems/venue-not-found", "title": "Venue not found", "status": 404, "detail": "I couldn't find that venue."}Booking not found
{ "type": "https://developers.kwickblocks.ai/problems/booking-not-found", "title": "Booking not found", "status": 404, "detail": "I couldn't find a booking with that reference and phone number."}Idempotency-Key conflict (https://developers.kwickblocks.ai/problems/idempotency-conflict)
RFC 9457 problem details. type is a URI with a page describing the problem.
object
Safe to read to a guest.
A machine-readable code on the widget’s routes.
Examples
Idempotency-Key conflict
{ "type": "https://developers.kwickblocks.ai/problems/idempotency-conflict", "title": "Idempotency-Key conflict", "status": 409, "detail": "That Idempotency-Key was already used for a different request."}Too many requests (https://developers.kwickblocks.ai/problems/rate-limited); Too many attempts (https://developers.kwickblocks.ai/problems/lookup-throttled)
RFC 9457 problem details. type is a URI with a page describing the problem.
object
Safe to read to a guest.
A machine-readable code on the widget’s routes.
Examples
Too many requests
{ "type": "https://developers.kwickblocks.ai/problems/rate-limited", "title": "Too many requests", "status": 429, "detail": "There have been too many requests. Please try again in a minute."}Too many attempts
{ "type": "https://developers.kwickblocks.ai/problems/lookup-throttled", "title": "Too many attempts", "status": 429, "detail": "Too many attempts. Please try again later."}