---
title: "Create a group reservation"
method: POST
path: "/reservations-v3/group"
tags: ["Group Reservations Open Api [Beta]"]
---

# Create a group reservation

`POST /reservations-v3/group`

This endpoint allows the creation of a group reservation, based on an array of quotes

## Request body

- object
  - `quoteAndRatePlanIds` object[], required — An array of objects containing quote IDs and rate plan IDs
    - `quoteId` string, required — The quote ID
    - `ratePlanId` string, required — The rate plan ID
    - `status` 'confirmed' | 'reserved' | 'awaiting_payment' | 'inquiry' | 'canceled' | 'closed' | 'declined' | 'expired' — Status for an individual reservation, if not defined we will use the status of the group
    - `booker` object — The booker for specific reservation
      - `_id` string, required — The booker ID
      - `fullName` string, required — The booker's full name
  - `name` string, required
  - `source` string — Source of reservation
  - `status` 'confirmed' | 'reserved' | 'awaiting_payment' | 'inquiry' | 'canceled' | 'closed' | 'declined' | 'expired'
  - `reservedUntil` -1 | 0.5 | 0.25 | 0.17 | 12 | 24 | 36 | 48 | 72 — Indicates for how long a reservation is valid after creation (in hours)
  - `note` string — The reservation notes
  - `groupBooker` object — The default booker for group reservation
    - `_id` string, required — The booker ID
    - `fullName` string, required — The booker's full name
  - `coupons` string[] — List of coupons
  - `chargeMethod` 'PER_GROUP' | 'PER_RESERVATION', required — The charge method for the group reservation (PER_GROUP method is not applicable to to accounting users)

## Response `201`

The group reservation has been created successfuly

- object
  - `_id` object, required
  - `accountId` object, required
  - `sendQuoteId` object
  - `platform` string, required
  - `name` string, required
  - `source` string, required
  - `bookerId` string
  - `createdAt` string, date-time, required
  - `note` string, required
  - `confirmationCode` string, required

## Other responses

- `400` — Group reservation creating failed

---

[API](https://skmtc.net/guesty/apis/guesty-open-api.md) · [All operations](https://skmtc.net/guesty/apis/guesty-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/guesty/guesty-open-api/versions/7c62644070f2/schema)