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

# Create a confirmed owner reservation

`POST /reservations-v3/owner/confirmed`

Create a confirmed owner reservation - This endpoint enables the creation of an Owner Reservation instantly with minimal required input. It is designed for simplicity and speed, focusing on essential details only. Behind the scenes, it will create a quote + reservation from a quote picking the first applicable rate plan and promotions

## Request body

- object
  - `checkInDateLocalized` string, required — The date when the Owner will check in - with the format of YYYY-MM-DD
  - `checkOutDateLocalized` string, required — The date when the Owner will check out - with the format of YYYY-MM-DD
  - `listingId` string, required — Listing Id of the unit that the Owner will be staying in
  - `guestId` string — Guest id of the guest that will be staying in
  - `guest` object — The Owner or Owner's guest for specific reservation
    - `firstName` string, required — Guest's first name
    - `lastName` string, required — Guest's last name
    - `phones` string[], required — The guest’s phone numbers written in E.164 format: [+] [country code] [subscriber number including area code]
    - `email` string, required — Guest's primary email address
    - `address` object — Guest's address
      - `street` string — The street address, including house number and street name. It can also be a PO Box
      - `zipCode` string — The postal code or ZIP code of the address
      - `city` string — The name of the city or town or village
      - `state` string — The state or province name
      - `country` string — The [full name](https://www.iban.com/country-codes) of the country
      - `countryCode` string — The two-letter [ISO 3166 Alpha-2](https://www.iban.com/country-codes) country code
    - `preferredLanguage` string
  - `numberOfGuests` object — Total number of guests with breakdown
    - `numberOfChildren` number — Number of children in the reservation. It can be zero
    - `numberOfInfants` number — Number of infants in the reservation. It can be zero
    - `numberOfPets` number — Number of pets in the reservation. It can be zero
    - `numberOfAdults` number — Count of adults, must be > 0
  - `source` 'owner' | 'owner-guest', required — Source of reservation. "owner" for owner reservations, "owner-guest" for owner friends & family reservations
  - `guestsCount` number — Count of guests
  - `notes` object — The reservation notes
    - `other` string — Other notes
    - `cleaning` string — Notes for cleaning
    - `guest` string — For notes about the guest
    - `specialRequests` string — For recording the guest's special requests
    - `keyCode` string — Store the relevant key code for using with workflow automation
    - `doneBy` string — The name of the Guesty user
  - `creationInfo` object, required — Keeps info about who created the reservation.
    - `owner` object, required
      - `_id` string, required — The owner ID
      - `fullName` string — The owner's full name
      - `email` string — The owner's email
      - `phone` string — The owner's phone number
      - `locale` string — The owner's locale
  - `bookingDate` string, date-time — Real-world booking/creation date. Defaults to createdAt when omitted.

## Response `200`

Reservation created

- object
  - `reservationId` string, required
  - `quoteId` string, required
  - `confirmationCode` string, required
  - `status` string, required
  - `guestId` string, required
  - `numberOfGuests` object, required
    - `numberOfChildren` number — Number of children
    - `numberOfInfants` number — Number of infants
    - `numberOfPets` number — Number of pets
    - `numberOfAdults` number, required — Number of adults
  - `creationTime` string, date-time, required
  - `bookingDate` string, date-time, required
  - `reservedExpiresAt` string, date-time, required
  - `checkInDate` string, date-time, required
  - `checkOutDate` string, date-time, required
  - `unitTypeId` string, required
  - `unitId` string, required
  - `source` string, required
  - `channel` string, required
  - `guestsCount` number, required
  - `creationInfo` object, required

## Other responses

- `201`
- `422` — Validation error failed from create reservation.

---

[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)
