Create a listing

post

https://open-api.guesty.com/v1/listings

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Any full address will do, we advise using the full property (the data will be parsed to the rest of the fields). PMS is automatically ON for this listing.

address

object

required

title

string

required

origin

string

Marks the origin platform that the listing was migrated from

originId

string

Marks the origin platform listing ID

accommodates

number

Defaults to 2

bathrooms

number

deprecated

Starting March 4th 2025, the bathroom field will be deprecated. Please use the Spaces endpoints to add and manage bathroom details moving forward.

minimumAge

number

prices

object

required

terms

object

required

timezone

string

Defaults to Asia/Jerusalem

propertyType

string

enum

Describes the kind of property where your guest will stay (e.g., Apartment, House, Villa, Boat, Tent, etc.). Corresponds to the Property type in the UI

roomType

string

enum

Indicates the level of privacy your guest will have during their stay (e.g., Entire home/apt, Private room, or Shared room). Corresponds to the Listing type in the UI

Allowed:

otaRoomType

string

enum

A Booking.com-specific field that defines either the property type or room capacity, depending on whether the stay is in a full unit or a single-room setup (e.g., Suite, Double, Villa, Bed in dormitory). Corresponds to the Room type in the UI

pictures

array of objects

required

pictures*

defaultCheckInTime

string

Defaults to 15:00

defaultCheckOutTime

string

Defaults to 10:00

type

string

enum

required

Listing type

Allowed:

tags

pms

object

owners

array

Defaults to

The owner should be an ID, not just a string

owners

nickname

string

required

Listing nickname

amenities

array of strings

amenities

mtl

object

In case if you are going to create a listing with the child unit, please fill in 'mtl' object

manageSubunitPictures

boolean

isListed

boolean

numberOfChildrenToCreate

number

Response

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Listing