beds24_get_token_details
Get token details
Check the configured Beds24 token: whether it is valid, its scopes, owner id, expiry, and whether it is restricted to one property. A cheap way to confirm setup and see which scopes are granted. Note Beds24 answers HTTP 200 with validToken=false for a bad token. Beds24: GET /authentication/details.
無需輸入參數。
beds24_list_properties
List properties
List the properties in the account with their address, currency, check-in times and room types (roomTypes). Optional flags include texts, pictures, offers, unit details and all rooms. Requires the properties scope. Beds24: GET /properties.
輸入參數pageroomIdspropertyIdsincludeTextsincludeOffersincludeAllRoomsincludePicturesincludeLanguagesincludePriceRulesincludeUnitDetailsincludeUpsellItems
beds24_list_bookings
List bookings
Search bookings by arrival/departure date range, booking or modified time, property, room, channel, status, or a free-text search over guest name, email, booking id and API reference. With NO filters Beds24 returns only upcoming bookings. `filter` shortcuts: arrivals (arriving today), departures (departing today), new (created in the last 24h), current (in-house). Guest data needs the bookings-personal scope, invoice items bookings-financial. Beds24: GET /bookings.
輸入參數pagefilterstatusarrivalchannelroomIdsarrivalTodeparturemasterIdsbookingIdsmodifiedToarrivalFrom另有 12 個
beds24_get_booking
Get a booking
Fetch one booking by id with its invoice items, info items and additional guests. Works for any status, including cancelled. Beds24: GET /bookings?id=<id>.
輸入參數bookingId必填
beds24_list_booking_messages
List booking messages
Read the guest conversation on bookings — messages from guests, host replies, internal notes and system messages — across channels (Airbnb, Booking.com, Vrbo, direct). Filter by booking, property, room, read/unread, source and age. Beds24: GET /bookings/messages.
輸入參數pagefiltermaxAgesourceroomIdsmasterIdsbookingIdsmessageIdspropertyIds
beds24_list_booking_invoices
List booking invoices
List invoices and their line items (charges and payments) for bookings. Requires the bookings-financial scope. Beds24 marks this endpoint Alpha. Beds24: GET /bookings/invoices.
輸入參數pagebookingIds
beds24_get_room_offers
Get room offers (quote)
Quote a stay: bookable offers with total price and units available per room for given dates and guests. Use before creating a booking. Beds24: GET /inventory/rooms/offers.
輸入參數pagearrival必填roomIdsofferIdsagentCodedeparture必填numAdults必填numChildrenpropertyIdsincludeTexts
beds24_get_room_availability
Get room availability
Per-date availability (true/false) for rooms over a range of nights. endDate is the LAST NIGHT (the day before check-out). Beds24: GET /inventory/rooms/availability.
輸入參數pageendDateroomIdsstartDatepropertyIds
beds24_get_unit_bookings
Get unit bookings (occupancy grid)
Which units of each room type are booked on each date — an occupancy grid keyed by date. endDate is the last night. Beds24 marks this endpoint Beta. Beds24: GET /inventory/rooms/unitBookings.
輸入參數pageendDateroomIdsstartDatepropertyIds
beds24_get_room_calendar
Get room calendar
Per-day calendar values for rooms: units available, min/max stay, multiplier, override (blackout, no check-in, ...) and the price slots price1..price16, as date ranges. Choose fields with the include flags; if none are set this tool asks for numAvail, minStay, maxStay, override and prices. Beds24: GET /inventory/rooms/calendar.
輸入參數pageendDate必填roomIdsstartDate必填propertyIdsincludePricesincludeMaxStayincludeMinStayincludeChannelsincludeNumAvailincludeOverrideincludeMultiplier另有 1 個
beds24_list_fixed_prices
List fixed prices
List fixed price rules (seasonal rates): date span, min/max nights, per-room and per-person prices, discounts, allowed arrival days and channel export. Beds24: GET /inventory/fixedPrices.
輸入參數pageroomIdspropertyIdsfixedPriceIdsincludeRateCodes
beds24_list_booking_com_reviews
List Booking.com reviews
Guest reviews from Booking.com for one property, made on or after a date: scores, content, reviewer and any reply. At most 100 per call. Beds24 marks this endpoint Alpha. Beds24: GET /channels/booking/reviews.
輸入參數from必填propertyId必填
beds24_list_airbnb_reviews
List Airbnb reviews
Guest reviews from Airbnb for one room: overall and category ratings, public review, private feedback and the host response. At most 100 per call. Beds24 marks this endpoint Beta. Beds24: GET /channels/airbnb/reviews.
輸入參數roomId必填
beds24_create_booking
Create a booking
Create a new booking in a room for given dates and guest details. It immediately blocks inventory and is synced to connected channels. Set checkAvailability=true to refuse the booking if the room is not free, and notifyGuest / notifyHost to send confirmation emails. Undo by setting status cancelled with beds24_update_booking. Requires a token with bookings write access. Beds24: POST /bookings.
輸入參數taxcitylangemailnotesphonepricestatetitlemobileroomId必填status另有 22 個
beds24_update_booking
Update a booking
Change an existing booking: dates, room/unit, guest counts, guest details, notes, flag, price, or status (e.g. confirmed, or cancelled to cancel — reversible by setting it back). Only the fields you pass change. Optionally add info items (code/text pairs). Changes sync to channels where allowed. Beds24: POST /bookings with the booking id.
輸入參數taxcitylangemailnotesphonepricestatetitlemobileroomIdstatus另有 21 個
beds24_send_booking_message
Send a booking message
Send a message on a booking's conversation. With source host (default) it is delivered to the GUEST through their channel (Airbnb, Booking.com, Vrbo, email) and cannot be unsent; with source internalNote it is a private host note. Beds24: POST /bookings/messages.
輸入參數sourcemessage必填bookingId必填
beds24_mark_messages_read
Mark messages read
Mark one or more booking messages as read (or unread with read=false). Beds24: POST /bookings/messages with [{ id, read }].
輸入參數readmessageIds必填
beds24_update_room_calendar
Update room calendar
Set per-day calendar values for ONE room over a date range: units available (numAvail), minStay, maxStay, multiplier, override (none, blackout, exception, noCheckIn, noCheckOut, noCheckInOrCheckOut) and price slots price1..price16. Set a price to null to remove it. These values sync to channels. Read the current values first with beds24_get_room_calendar so you can restore them. Beds24: POST /inventory/rooms/calendar.
輸入參數to必填from必填price1price2price3price4price5price6price7price8price9roomId必填另有 12 個