Update Listing

post

https://app.hosttools.com/api/setListing/{listingID}

Updates listing details. Send any subset of the fields below; omitted
fields are left unchanged, and null clears a nullable field. Each
field documents its own constraints — values that violate them return
400.

Enabling a listing. Turning on messaging, availability, or pricing
enables the listing — you're billed for any enabled listing, and turning
all three off disables it. Enable them individually, but turning on
availability or pricing also turns on messaging.

Toggle	Field	What enabling it does	Also enables messaging
Messaging	`messagingEnabled`	Lets messages be sent and received	—
Availability	`syncAvailability`	Syncs the connected calendars	Yes
Pricing	`syncPricing`	Syncs prices and restrictions	Yes

Enabling sync. Turning on syncPricing or syncAvailability returns
400 if the listing's Airbnb account is in setup mode (no calendar
permission — reconnect in full mode first), or it's a co-hosted listing
whose owner hasn't granted sync permission yet. syncPricing also needs
an effective minNights of at least 1 (sent in the request or already
stored), and neither toggle can be enabled while turning
messagingEnabled off — messaging is the master switch. When a sync
toggle change triggers an immediate Airbnb push, the response includes
syncPushed (false = push failed but settings are saved; the next
periodic sync reconciles).

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

listingID

string

required

_id of listing to update

Body Params

Listing update fields

messagingEnabled

boolean

Lets guest messages be sent and received for this listing.
The master switch: availability and pricing sync only run
while messaging is on.

syncPricing

boolean

Syncs prices and restrictions (calendar prices, base &
minimum price, minimum nights, check-in/out rules,
discounts). Enabling also turns messaging on; see "Enabling
sync" above for when it's blocked.

syncAvailability

boolean

Syncs availability across the connected calendars. Enabling
also turns messaging on; see "Enabling sync" above for when
it's blocked.

weeklyDiscount

number | null

0 to 100

Weekly discount percent (0-100). Pass null to clear.

monthlyDiscount

number | null

0 to 100

nonRefundableDiscount

number | null

0 to 100

linkedRoomID

string | null

Set this listing's parent room (for multi-unit setups). Pass
null to unlink. The target must belong to the same user and
must not create a cycle.

priceSource

string

enum

Where synced prices come from. API means the prices you
push via the setPrices endpoint (update prices via the API
before selecting it). Use Listing to mirror another listing
(set priceSourceListingID). Changing this also enables
pricing and availability sync unless you send those toggles
explicitly, so the same "Enabling sync" checks apply.

Allowed:

priceSourceListingID

string | null

Required when priceSource = "Listing".

minPrice

number | null

≥ 0

Minimum nightly price. Pass null to clear.

bookingWindow

number

enum

Availability window in days.

calendars

array of objects

iCal import URLs. Pass an empty array to clear all
user-added calendars. Auto-added entries (e.g. from a
channel sync) are always preserved.

calendars

name

string

address

string

Postal address. When changed, we geocode it to derive the
listing's location components (city, region, country,
countryCode, zipcode, latitude, longitude, timeZone); a
poorly-structured or ambiguous address fails validation
(400). An unchanged address skips the geocoder.

checkInTime

number

0 to 23

Check-in hour, 0–23.

checkOutTime

number

0 to 23

Check-out hour, 0–23.

currency

string

^[A-Z]{3}$

3-letter ISO 4217 code (e.g. USD).

timeZone

string

IANA timezone name.

bedrooms

number

≥ 0

bathrooms

number

≥ 0

notes

object

neighborhoodOverview

object

about

object

keyCollection

object

policy

object

minNights

number

≥ 1

Optional; when sent must be at least 1. You only need to
send it when changing it.

basePrice

number

≥ 0

maxGuests

number

≥ 0

space

number

≥ 0

spaceUnit

string

enum

Allowed:

upsellURL

uri | null

URL used by the {{Upsell URL}} message tag. Pass null to clear.

Headers

apiKey

string

Partner API key (deprecated — use OAuth 2.0 for new integrations)

authToken

string

User's authentication token (legacy). Use Authorization Bearer header for new integrations.

Responses

429

Too many requests

200Listing updated successfully

400Error