Group

Add one or multiple reservations to an existing group booking using blocked inventory.

Creates new reservations and adds them to an existing group booking taking a list of reservations as input<br>You must have at least one of these scopes: 'groups.manage, reservations.manage'.

post/booking/v1/groups/{id}/reservations

Path parameters

idstring required

Id of the group booking the reservations should be attached to.

Headers

Idempotency-Keystring

Unique key for safely retrying requests without accidentally performing the same operation twice. We'll always send back the same response for requests made with the same key, and keys can't be reused with different request parameters. Keys expire after 24 hours.

Request body

Example request

{
  "reservations": [
    {
      "blockId": "MUC-QJNXJR",
      "arrival": "2026-09-03",
      "departure": "2026-09-05",
      "adults": 1,
      "comment": "I need a wake up service",
      "primaryGuest": {
        "title": "Mr",
        "gender": "Male",
        "firstName": "Jon",
        "middleInitial": "D",
        "lastName": "Doe",
        "email": "john.d@doe.com",
        "phone": "+4989123343",
        "address": {
          "addressLine1": "My Street 1",
          "postalCode": "12453",
          "city": "MyCity",
          "countryCode": "GB"
        },
        "company": {
          "name": "Company GmbH",
          "taxId": "1442"
        },
        "vehicleRegistration": {
          "number": "APA322",
          "countryCode": "DE"
        }
      }
    },
    {
      "blockId": "MUC-WKMCKT",
      "arrival": "2026-09-04",
      "departure": "2026-09-06",
      "adults": 1,
      "childrenAges": [
        6
      ],
      "primaryGuest": {
        "title": "Mr",
        "gender": "Male",
        "firstName": "Eric",
        "middleInitial": "E",
        "lastName": "Steinmetz",
        "email": "eric.e@steinmetz.com",
        "phone": "+4989123343",
        "address": {
          "addressLine1": "My Street 1",
          "postalCode": "12453",
          "city": "MyCity",
          "countryCode": "GB"
        },
        "vehicleRegistration": {
          "number": "APA322",
          "countryCode": "DE"
        }
      }
    }
  ]
}

Response

All new reservations were created and added to the group booking.

Example response

{
  "reservationIds": [
    {
      "id": "XPGMSXGF-1"
    },
    {
      "id": "XPGMSXGF-2"
    }
  ]
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.