POST

Create Reservation


Developer Preview

This API is subject to change. Bug fixes and new features will be released based on developer feedback throughout the preview period.

Creates a new reservation.

Create Reservation accepts and requires different fields depending on the status and source specified, and the permissions of the identity you're authenticated as.

Status and source

If a status is not specified, it will be set to:

  • RESERVED if manual approval is not required for confirmation
  • REQUESTED if manual approval is required for confirmation.

A reservation created with any source other than WALK_IN requires the reservation.reservee.phone and reservation.reservee.firstName fields. Attempting to create a reservation without these fields results in an error.

Permissions

The fields status, source, reservation.details.tableIds, reservation.details.endDate, ignoreReservationLocationConflicts, and ignoreTableCombinationConflicts should only be specified if you're authenticated as an identity with the MANAGE RESERVATIONS (FULL) permission scope. Specifying these fields without the required permissions results in an application error.

If source is not specified, its value is set depending on the permissions of the permissions of the identity you're authenticated as. If the identity has the MANAGE RESERVATIONS (FULL) permission scope the source is set to UNDEFINED. Otherwise, the source is set to ONLINE.

Note: Create Reservation requires all details of the reservation upfront. The process of creating a reservation can be broken up using Create Held Reservation. Create Held Reservation creates a temporary reservation that expires automatically unless it is completed with the addition of more details using Reserve Reservation.

Permissions
Manage Reservations (Basic)
Manage Reservations (Full)
Manage Reservations (Medium)
Manage Restaurants - all permissions
Learn more about app permissions.
Endpoint
POST
https://www.wixapis.com/table-reservations/reservations/v1/reservations

Errors
400Invalid Argument

There is 1 error with this status code:

428Failed Precondition

There is 1 error with this status code:

See the entire list and learn more about Wix errors.

Event TriggersThis method triggers the following events:
Did this help?