---
title: "POST /api/distributor/v1/reservationGroups/create"
method: POST
path: "/api/distributor/v1/reservationGroups/create"
tags: ["DistributorApi"]
---

# POST /api/distributor/v1/reservationGroups/create

`POST /api/distributor/v1/reservationGroups/create`

## Request body

- CreateReservationGroupParameters
  - `Client` string, required
  - `LanguageCode` string, nullable
  - `CultureCode` string, nullable
  - `FullAmounts` boolean, required
  - `Session` string, nullable
  - `HotelId` string, uuid, required
  - `ConfigurationId` string, uuid, nullable
  - `AvailabilityBlockId` string, uuid, nullable
  - `Customer` Customer, required
    - `Email` string, email, nullable
    - `FirstName` string, nullable
    - `LastName` string, required
    - `Telephone` string, tel, nullable
    - `NationalityCode` string, nullable
    - `SendMarketingEmails` boolean, nullable
  - `Booker` Customer
    - `Email` string, email, nullable
    - `FirstName` string, nullable
    - `LastName` string, required
    - `Telephone` string, tel, nullable
    - `NationalityCode` string, nullable
    - `SendMarketingEmails` boolean, nullable
  - `Reservations` Reservation[], required
    - `Id` string, uuid, required
    - `Identifier` string, nullable
    - `Number` string, required
    - `StartUtc` string, date-time, required
    - `EndUtc` string, date-time, required
    - `VoucherCode` string, nullable
    - `AvailabilityBlockId` string, uuid, nullable
    - `RoomCategoryId` string, uuid, required
    - `RateId` string, uuid, required
    - `Rate` Rate
      - `Id` string, uuid, required
      - `RateGroupId` string, uuid, required
      - `Ordering` integer, required
      - `Name` object, required
      - `Description` object, required
      - `IsPrivate` boolean, required
      - `CurrencyCode` string, currency, required
    - `ProductIds` string[], nullable
    - `AdultCount` integer, nullable
    - `ChildCount` integer, nullable
    - `OccupancyData` OccupancyData[], required
      - `AgeCategoryId` string, uuid, required
      - `PersonCount` integer, required
    - `Notes` string, nullable
    - `Cost` unknown, required
    - `Amount` unknown, required
  - `CreditCardData` CreditCardData
    - `PaymentGatewayData` string, nullable
    - `ObfuscatedCreditCardNumber` string, nullable
    - `Expiration` string, date, required
    - `HolderName` string, nullable

## Response `200`

OK

- ReservationGroup
  - `Id` string, uuid, required
  - `CustomerId` string, uuid, nullable
  - `Reservations` Reservation[], required
    - `Id` string, uuid, required
    - `Identifier` string, nullable
    - `Number` string, required
    - `StartUtc` string, date-time, required
    - `EndUtc` string, date-time, required
    - `VoucherCode` string, nullable
    - `AvailabilityBlockId` string, uuid, nullable
    - `RoomCategoryId` string, uuid, required
    - `RateId` string, uuid, required
    - `Rate` Rate
      - `Id` string, uuid, required
      - `RateGroupId` string, uuid, required
      - `Ordering` integer, required
      - `Name` object, required
      - `Description` object, required
      - `IsPrivate` boolean, required
      - `CurrencyCode` string, currency, required
    - `ProductIds` string[], nullable
    - `AdultCount` integer, nullable
    - `ChildCount` integer, nullable
    - `OccupancyData` OccupancyData[], required
      - `AgeCategoryId` string, uuid, required
      - `PersonCount` integer, required
    - `Notes` string, nullable
    - `Cost` unknown, required
    - `Amount` unknown, required
  - `PaymentRequestId` string, uuid, nullable
  - `TotalCost` unknown, required
  - `TotalAmount` unknown, required
  - `PaymentCardId` string, uuid, nullable
  - `CreditCardAvailable` boolean, required
  - `PaymentRequests` PaymentRequest[], nullable
    - `Id` string, uuid, required
    - `ReservationGroupId` string, uuid, required
    - `State` 'Pending' | 'Completed' | 'Canceled' | 'Expired', required
  - `Payments` Payment[], nullable
    - `Id` string, uuid, required
    - `EnterpriseId` string, uuid, required
    - `PaymentRequestId` string, uuid, nullable
    - `CreatedUtc` string, date-time, required
    - `State` 'Charged' | 'Canceled' | 'Pending' | 'Failed' | 'Verifying', required
    - `Amount` Amount, required
      - `Currency` string, currency, required
      - `GrossValue` number, double, required
      - `NetValue` number, double, required
      - `TaxValues` TaxValue[], required
        - `TaxRateCode` string, required
        - `Value` number, double, required
      - `Breakdown` TaxBreakdown, required
        - `Items` TaxBreakdownItem[], required
          - `TaxRateCode` string, nullable
          - `NetValue` number, double, required
          - `TaxValue` number, double, required
    - `ChargeAmount` Amount
      - `Currency` string, currency, required
      - `GrossValue` number, double, required
      - `NetValue` number, double, required
      - `TaxValues` TaxValue[], required
        - `TaxRateCode` string, required
        - `Value` number, double, required
      - `Breakdown` TaxBreakdown, required
        - `Items` TaxBreakdownItem[], required
          - `TaxRateCode` string, nullable
          - `NetValue` number, double, required
          - `TaxValue` number, double, required

---

[API](https://skmtc.dev/mews/apis/distributorapi.md) · [All operations](https://skmtc.dev/mews/apis/distributorapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mews/distributorapi/revisions/90516153f0ff/schema)
