Create a booking

POST {baseUrl}/queues/{queueId}/bookings

This endpoint is used to create a new booking within a specified queue.

Body Parameters

Parameter	Type	Description

Parameter	Type	Description
locale	string	Language locale for the booking. Example: `"en"` for English.
notification	object	Notification settings specifying the type and settings. See Notification Structure below.
numberOfPeople	integer	Number of people included in the booking.
booking	object	Contains start and end times of the booking. See Booking Time Structure below.

Notification Structure

Field	Type	Description

Field	Type	Description
type	string	Type of notification, e.g., `"phoneNumber"`
settings	object	Settings for the notification. Example includes `"to": "+48000"` for specifying a phone number.

Booking Time Structure

Field	Type	Description

Field	Type	Description
start	string (ISO DateTime)	Start time of the booking in ISO format.
end	string (ISO DateTime)	End time of the booking in ISO format.

Request

curl --location --request POST 'POST {baseUrl}/queues/{queueId}/bookings' \
--header 'Content-Type: application/json' \
--data-raw '{
    "locale": "en",
    "notification": {
        "type": "phoneNumber",
        "settings": {
            "to": "+48000"
        }
    },
    "numberOfPeople": 1,
    "booking": {
        "start": "2020-11-30T14:30:00.000Z",
        "end": "2020-11-30T14:35:00.000Z"
    }
}'

Response

{
    "location": null,
    "type": "booking",
    "priority": 100,
    "locale": "en",
    "notification": {
        "type": "phoneNumber",
        "settings": {
            "to": "+48000"
        }
    },
    "numberOfPeople": 1,
    "booking": {
        "start": "2020-11-30T14:30:00.000Z",
        "end": "2020-11-30T14:35:00.000Z"
    },
    "status": "draft",
    "label": "",
    "id": "5afc59af-0270-481b-a50d-73445dd21ec6",
    "queue": "64aa8a7f-a616-44e8-806a-165e08d91192",
    "createdAt": "2020-11-30T15:15:17.176Z",
    "QRCodeCheckInPositionId": "{\"type\":\"check-in-position\",\"positionId\":\"5afc59af-0270-481b-a50d-73445dd21ec6\"}",
    "bookingReminderAt": null
}