Logo PopinaPopina API

Create booking

Allows the POS to create a booking by providing the booking details and the location id.

POST/v1/bookings/
authorization<token>

To get an API key, please contact us. We'll be happy to help you.

In: header

Query Parameters

locationId?string
Formatuuid
guestCountnumber
Range1 <= value
bookedAtstring
Formatdate-time
tables
confirmedAt?string
Formatdate-time
firstName?string|null
customerId?string|null
lastName?string|null
comment?string|null
email?string|null
phone?string|null
policyStatus?string

This enum property is here to describe the status of the booking regarding the booking policy.

  • COMPLIANT: The booking is compliant with the booking policy.
  • FLAGGED: The booking is not compliant with the booking policy and has been flagged.
  • OVERRIDDEN: The booking is willingly not compliant with the booking policy and has been manually overridden by an user.
Default"COMPLIANT"
Value in"COMPLIANT" | "FLAGGED" | "OVERRIDDEN"
statusstring
Value in"CONFIRMED" | "PENDING"

Response Body

application/json

application/json

curl -X POST "http://localhost:4008/v1/bookings/" \  -H "Content-Type: application/json" \  -d '{    "firstName": "John",    "lastName": "Doe",    "email": "john.doe@gmail.com",    "bookedAt": "2025-01-01T19:00:00Z",    "status": "CONFIRMED",    "confirmedAt": "2024-01-01T12:00:00Z",    "phone": null,    "comment": null,    "guestCount": 2,    "policyStatus": "OVERRIDDEN",    "tables": [      {        "tableId": "1a8bad9e-3e89-4b4b-9732-271266db7c42"      }    ]  }'
{
  "id": "b1304537-a651-40e4-8a7a-0c8a567cb60f"
}
[
  "duringExceptionDisallowingBookings"
]