---
title: "Create Reservation"
method: POST
path: "/reservations"
tags: ["Reservations"]
---

# Create Reservation

`POST /reservations`

Create a reservation (Direct Booking) in Hostex.

## Request body

- object
  - `property_id` integer, required — The id of the property for the reservation.
  - `custom_channel_id` integer, required — The id of the custom channel through which the reservation is booked. See [Query Custom Channel](/reference/query-custom-channels) for retrieving custom channels.
  - `check_in_date` string, date, required — The check-in date for the reservation in YYYY-MM-DD format.
  - `check_out_date` string, date, required — The check-out date for the reservation in YYYY-MM-DD format.
  - `number_of_guests` integer — The total number of guests included in the reservation.
  - `guest_name` string, required — The name of the primary guest.
  - `email` string — The email address of the primary guest.
  - `mobile` string — The mobile phone number of the primary guest.
  - `currency` string, required — The currency code for the reservation amounts. See [Supported Currencies](/reference/supported-currencies) for more information.
  - `rate_amount` integer, required — The total rate amount for the reservation.
  - `commission_amount` integer, required — The commission amount for the reservation.
  - `received_amount` integer, required — The total amount received for the reservation.
  - `income_method_id` integer, required — The identifier for the income method used for the reservation payment. See [Query Income methods](/reference/query-income-methods) for retrieving all income methods.
  - `remarks` string — Any additional remarks related to the reservation.

## Response `200`

The request has been successfully submitted.

- CommonResponse
  - `request_id` string, required — Unique identifier for the request.
  - `error_code` integer, required — Numeric error code representing the status of the response. A value of `200` indicates success. <br> See the [Error Codes](/reference/error-manual#error-codes) section for more information.
  - `error_msg` string, required — Message detailing the status of the response.

---

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