Set Calendar

Sets prices, minimum nights, check-in and check-out blocks, and blocked dates on a listing's calendar. Send one entry per date, with only the fields you want to change.

blocked: true blocks the date, the same as blocking it on the Host Tools calendar, so it reaches the listing's channels the same way. blocked: false removes the block. It can't open a date held by a reservation or a calendar rule. Blocking works on any listing, whatever its price source.

price, minNights, blockCheckin and blockCheckout only apply to listings whose price source is API (see priceSource on Set Listing). minNights, blockCheckin and blockCheckout also need a price from this endpoint on the same date. On other listings, Host Tools stores these values but doesn't use them.

Host Tools only updates dates already on the calendar, about two years ahead, and ignores later ones. Changes reach the channels in the background. Get Calendar shows a new block as blocked: true once Host Tools has recalculated the calendar.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

_id of listing to update

Body Params

Post body

prices
array of objects
required

One entry per date. Send only the fields you want to change for that date.

prices*
Headers
string

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

string

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

Responses

429

Too many requests

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json