MCP 服务器

beds24

io.usefulapi/beds24
商业与运营 旅行与酒店 公开且可连接 MCP 2026-07-28

此 MCP 可以做什么

Manages Beds24 lodging properties, bookings, availability, rates, room calendars, guest messages, reviews and booking invoices.

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.
可能执行破坏性操作
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['roomId', 'arrival', 'departure'], 'properties': {'tax': {'type': 'number'}, 'city': {'type': 'string'}, 'lang': {'type': 'string', 'description': 'Guest language, 2-letter code, e.g. en.'}, 'email': {'type': 'string'}, 'notes': {'type': 'string', 'description': 'Internal host notes.'}, 'phone': {'type': 'string'}, 'price': {'type': 'number', 'description': 'Total booking price.'}, 'state': {'type': 'string'}, 'title': {'type': 'string', 'description': 'Guest title, e.g. Mr, Ms.'}, 'mobile': {'type': 'string'}, 'roomId': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Room (room type) id.', 'exclusiveMinimum': 0}, 'status': {'enum': ['confirmed', 'request', 'new', 'cancelled', 'black', 'inquiry'], 'type': 'string', 'description': 'Booking status.'}, 'unitId': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Specific unit within the room type.', 'exclusiveMinimum': 0}, 'address': {'type': 'string'}, 'arrival': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Arrival date, YYYY-MM-DD.'}, 'company': {'type': 'string'}, 'country': {'type': 'string', 'description': 'Free text country.'}, 'deposit': {'type': 'number'}, 'comments': {'type': 'string', 'description': 'Guest comments.'}, 'country2': {'type': 'string', 'maxLength': 2, 'minLength': 2, 'description': '2-letter country code, e.g. DE.'}, 'flagText': {'type': 'string'}, 'lastName': {'type': 'string'}, 'numAdult': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Number of adults.'}, 'numChild': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Number of children.'}, 'postcode': {'type': 'string'}, 'departure': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Departure (check-out) date, YYYY-MM-DD.'}, 'firstName': {'type': 'string'}, 'flagColor': {'type': 'string', 'pattern': '^([0-9a-fA-F]{6})?$', 'description': 'Flag colour, 6-character hex (e.g. ff0000) or empty string to clear.'}, 'reference': {'type': 'string', 'maxLength': 100, 'description': 'Your own reference.'}, 'notifyHost': {'type': 'boolean', 'description': 'Email the host a booking confirmation.'}, 'arrivalTime': {'type': 'string', 'description': 'Expected arrival time (free text).'}, 'notifyGuest': {'type': 'boolean', 'description': 'Email the guest a booking confirmation.'}, 'assignBooking': {'type': 'boolean', 'description': 'Let Beds24 assign the first free unit / room using room dependency settings.'}, 'checkAvailability': {'type': 'boolean', 'description': 'Do not save the booking if the room has no availability. Recommended.'}}}
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>.
只读
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['bookingId'], 'properties': {'bookingId': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'The booking id.', 'exclusiveMinimum': 0}}}
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.
只读
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'Page number beyond the first (2, 3, ...). Check pages.nextPageExists in the previous response.'}, 'endDate': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Last night (day before check-out), YYYY-MM-DD.'}, 'roomIds': {'type': 'array', 'items': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'maxItems': 100, 'minItems': 1, 'description': 'One or more room ids.'}, 'startDate': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'First night, YYYY-MM-DD.'}, 'propertyIds': {'type': 'array', 'items': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'maxItems': 100, 'minItems': 1, 'description': 'One or more property ids.'}}}
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.
只读
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['startDate', 'endDate'], 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'Page number beyond the first (2, 3, ...). Check pages.nextPageExists in the previous response.'}, 'endDate': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Last date, YYYY-MM-DD.'}, 'roomIds': {'type': 'array', 'items': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'maxItems': 100, 'minItems': 1, 'description': 'One or more room ids.'}, 'startDate': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'First date, YYYY-MM-DD.'}, 'propertyIds': {'type': 'array', 'items': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'maxItems': 100, 'minItems': 1, 'description': 'One or more property ids.'}, 'includePrices': {'type': 'boolean'}, 'includeMaxStay': {'type': 'boolean'}, 'includeMinStay': {'type': 'boolean'}, 'includeChannels': {'type': 'boolean', 'description': 'Include per-channel booking limits.'}, 'includeNumAvail': {'type': 'boolean'}, 'includeOverride': {'type': 'boolean'}, 'includeMultiplier': {'type': 'boolean'}, 'includeLinkedPrices': {'type': 'boolean'}}}
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.
只读
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['arrival', 'departure', 'numAdults'], 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'Page number beyond the first (2, 3, ...). Check pages.nextPageExists in the previous response.'}, 'arrival': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Arrival date, YYYY-MM-DD.'}, 'roomIds': {'type': 'array', 'items': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'maxItems': 100, 'minItems': 1, 'description': 'One or more room ids.'}, 'offerIds': {'type': 'array', 'items': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'maxItems': 100, 'minItems': 1, 'description': 'One or more offer ids.'}, 'agentCode': {'type': 'string'}, 'departure': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Departure date, YYYY-MM-DD.'}, 'numAdults': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'Number of adults.'}, 'numChildren': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0}, 'propertyIds': {'type': 'array', 'items': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'maxItems': 100, 'minItems': 1, 'description': 'One or more property ids.'}, 'includeTexts': {'type': 'array', 'items': {'type': 'string', 'maxLength': 2, 'minLength': 2}, 'description': 'Include descriptive texts in these 2-letter languages, e.g. ["en"].'}}}
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.
只读
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {}}
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.
只读
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'Page number beyond the first (2, 3, ...). Check pages.nextPageExists in the previous response.'}, 'endDate': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Last night, YYYY-MM-DD.'}, 'roomIds': {'type': 'array', 'items': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'maxItems': 100, 'minItems': 1, 'description': 'One or more room ids.'}, 'startDate': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'First night, YYYY-MM-DD.'}, 'propertyIds': {'type': 'array', 'items': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'maxItems': 100, 'minItems': 1, 'description': 'One or more property ids.'}}}
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.
只读
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['roomId'], 'properties': {'roomId': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'The Beds24 room id linked to the Airbnb listing.', 'exclusiveMinimum': 0}}}
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.
只读
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['propertyId', 'from'], 'properties': {'from': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Reviews made on or after this date, YYYY-MM-DD.'}, 'propertyId': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'The property id.', 'exclusiveMinimum': 0}}}
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.
只读
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'Page number beyond the first (2, 3, ...). Check pages.nextPageExists in the previous response.'}, 'bookingIds': {'type': 'array', 'items': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'maxItems': 100, 'minItems': 1, 'description': 'One or more booking ids.'}}}
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.
只读
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'Page number beyond the first (2, 3, ...). Check pages.nextPageExists in the previous response.'}, 'filter': {'enum': ['read', 'unread'], 'type': 'string'}, 'maxAge': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'Only messages from the last N days.'}, 'source': {'enum': ['host', 'guest', 'internalNote', 'system'], 'type': 'string', 'description': 'Only messages from one side.'}, 'roomIds': {'type': 'array', 'items': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'maxItems': 100, 'minItems': 1, 'description': 'One or more room ids.'}, 'masterIds': {'type': 'array', 'items': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'maxItems': 100, 'minItems': 1, 'description': 'One or more group master booking ids.'}, 'bookingIds': {'type': 'array', 'items': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'maxItems': 100, 'minItems': 1, 'description': 'One or more booking ids.'}, 'messageIds': {'type': 'array', 'items': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'maxItems': 100, 'minItems': 1, 'description': 'One or more message ids.'}, 'propertyIds': {'type': 'array', 'items': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'maxItems': 100, 'minItems': 1, 'description': 'One or more property ids.'}}}
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.
只读
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'Page number beyond the first (2, 3, ...). Check pages.nextPageExists in the previous response.'}, 'filter': {'enum': ['arrivals', 'departures', 'new', 'current'], 'type': 'string'}, 'status': {'type': 'array', 'items': {'enum': ['confirmed', 'request', 'new', 'cancelled', 'black', 'inquiry'], 'type': 'string'}, 'description': 'Statuses to include. Defaults to all except cancelled.'}, 'arrival': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Exact arrival date.'}, 'channel': {'enum': ['agoda', 'airbnb', 'asiatravel', 'atraveode', 'booking', 'bookingpage', 'despegar', 'direct', 'edreamsodigeo', 'expedia', 'feratel', 'goibibo', 'hometogo', 'hostelworld', 'hotelbeds', 'hrs', 'jomres', 'marriott', 'ostrovokru', 'ota', 'tiket', 'tomastravel', 'traveloka', 'travia', 'traum', 'trip', 'tripadvisorrentals', 'vacationstay', 'vrbo', 'airbnbical', 'bedandbreakfasteu', 'bedandbreakfastnl', 'bookeasycomau', 'bookitconz', 'flipkey', 'googlecal', 'googleads', 'guestlinkcouk', 'holidaylettingscouk', 'hostelinternational', 'hostelsclub', 'housetripcom', 'icalimport1', 'icalimport2', 'icalimport3', 'lastminute', 'nzaa', 'reserva', 'rezintelnet', 'tablethotels', 'traumferienwohnungen', 'trivagocom', 'visitscotlandcom', 'vrboical', 'webroomsconz'], 'type': 'string', 'description': 'Only bookings from this channel.'}, 'roomIds': {'type': 'array', 'items': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'maxItems': 100, 'minItems': 1, 'description': 'One or more room ids.'}, 'arrivalTo': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Date, YYYY-MM-DD.'}, 'departure': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Exact departure date.'}, 'masterIds': {'type': 'array', 'items': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'maxItems': 100, 'minItems': 1, 'description': 'One or more group master booking ids.'}, 'bookingIds': {'type': 'array', 'items': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'maxItems': 100, 'minItems': 1, 'description': 'One or more booking ids.'}, 'modifiedTo': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}$', 'description': 'Modified before this time.'}, 'arrivalFrom': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Date, YYYY-MM-DD.'}, 'departureTo': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Date, YYYY-MM-DD.'}, 'propertyIds': {'type': 'array', 'items': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'maxItems': 100, 'minItems': 1, 'description': 'One or more property ids.'}, 'modifiedFrom': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}$', 'description': 'Modified after this time.'}, 'searchString': {'type': 'string', 'description': 'Matches guest name, email, apiReference or booking id.'}, 'apiReferences': {'type': 'array', 'items': {'type': 'string'}, 'minItems': 1, 'description': 'Channel / API references.'}, 'bookingTimeTo': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}$', 'description': 'Booked before this time (UTC).'}, 'departureFrom': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Date, YYYY-MM-DD.'}, 'includeGuests': {'type': 'boolean', 'description': 'Include additional guests (bookings-personal scope).'}, 'bookingTimeFrom': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}$', 'description': 'Booked after this time (UTC).'}, 'includeInfoItems': {'type': 'boolean'}, 'includeBookingGroup': {'type': 'boolean'}, 'includeInvoiceItems': {'type': 'boolean'}}}
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.
只读
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'Page number beyond the first (2, 3, ...). Check pages.nextPageExists in the previous response.'}, 'roomIds': {'type': 'array', 'items': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'maxItems': 100, 'minItems': 1, 'description': 'One or more room ids.'}, 'propertyIds': {'type': 'array', 'items': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'maxItems': 100, 'minItems': 1, 'description': 'One or more property ids.'}, 'fixedPriceIds': {'type': 'array', 'items': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'maxItems': 100, 'minItems': 1, 'description': 'One or more fixed price ids.'}, 'includeRateCodes': {'type': 'boolean'}}}
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.
只读
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'properties': {'page': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 1, 'description': 'Page number beyond the first (2, 3, ...). Check pages.nextPageExists in the previous response.'}, 'roomIds': {'type': 'array', 'items': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'maxItems': 100, 'minItems': 1, 'description': 'One or more room ids.'}, 'propertyIds': {'type': 'array', 'items': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'maxItems': 100, 'minItems': 1, 'description': 'One or more property ids.'}, 'includeTexts': {'type': 'array', 'items': {'enum': ['all', 'property', 'roomType'], 'type': 'string'}, 'description': 'Which descriptive texts to include.'}, 'includeOffers': {'type': 'boolean', 'description': 'Include offers per room.'}, 'includeAllRooms': {'type': 'boolean', 'description': 'Include every room type of each property.'}, 'includePictures': {'type': 'boolean'}, 'includeLanguages': {'type': 'array', 'items': {'type': 'string', 'maxLength': 3, 'minLength': 2}, 'description': 'Languages for texts, e.g. ["en"] or ["all"].'}, 'includePriceRules': {'type': 'boolean'}, 'includeUnitDetails': {'type': 'boolean', 'description': 'Include full unit details (by default only unit names).'}, 'includeUpsellItems': {'type': 'boolean'}}}
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 }].
可能执行破坏性操作
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['messageIds'], 'properties': {'read': {'type': 'boolean', 'description': 'true (default) = read, false = unread.'}, 'messageIds': {'type': 'array', 'items': {'type': 'integer', 'maximum': 9007199254740991, 'exclusiveMinimum': 0}, 'maxItems': 100, 'minItems': 1, 'description': 'Message ids.'}}}
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.
可能执行破坏性操作
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['bookingId', 'message'], 'properties': {'source': {'enum': ['host', 'internalNote'], 'type': 'string', 'description': 'host (to the guest, default) or internalNote (private).'}, 'message': {'type': 'string', 'maxLength': 10000, 'minLength': 1, 'description': 'Message text.'}, 'bookingId': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'The booking id.', 'exclusiveMinimum': 0}}}
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.
可能执行破坏性操作
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['bookingId'], 'properties': {'tax': {'type': 'number'}, 'city': {'type': 'string'}, 'lang': {'type': 'string', 'description': 'Guest language, 2-letter code, e.g. en.'}, 'email': {'type': 'string'}, 'notes': {'type': 'string', 'description': 'Internal host notes.'}, 'phone': {'type': 'string'}, 'price': {'type': 'number', 'description': 'Total booking price.'}, 'state': {'type': 'string'}, 'title': {'type': 'string', 'description': 'Guest title, e.g. Mr, Ms.'}, 'mobile': {'type': 'string'}, 'roomId': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Room (room type) id.', 'exclusiveMinimum': 0}, 'status': {'enum': ['confirmed', 'request', 'new', 'cancelled', 'black', 'inquiry'], 'type': 'string', 'description': 'Booking status.'}, 'unitId': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'Specific unit within the room type.', 'exclusiveMinimum': 0}, 'address': {'type': 'string'}, 'arrival': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Arrival date, YYYY-MM-DD.'}, 'company': {'type': 'string'}, 'country': {'type': 'string', 'description': 'Free text country.'}, 'deposit': {'type': 'number'}, 'comments': {'type': 'string', 'description': 'Guest comments.'}, 'country2': {'type': 'string', 'maxLength': 2, 'minLength': 2, 'description': '2-letter country code, e.g. DE.'}, 'flagText': {'type': 'string'}, 'lastName': {'type': 'string'}, 'numAdult': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Number of adults.'}, 'numChild': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': 0, 'description': 'Number of children.'}, 'postcode': {'type': 'string'}, 'bookingId': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'The booking id to change.', 'exclusiveMinimum': 0}, 'departure': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Departure (check-out) date, YYYY-MM-DD.'}, 'firstName': {'type': 'string'}, 'flagColor': {'type': 'string', 'pattern': '^([0-9a-fA-F]{6})?$', 'description': 'Flag colour, 6-character hex (e.g. ff0000) or empty string to clear.'}, 'reference': {'type': 'string', 'maxLength': 100, 'description': 'Your own reference.'}, 'arrivalTime': {'type': 'string', 'description': 'Expected arrival time (free text).'}, 'notifyGuest': {'type': 'boolean', 'description': 'Email the guest an updated confirmation.'}, 'addInfoItems': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'text'], 'properties': {'code': {'type': 'string', 'minLength': 1}, 'text': {'type': 'string'}}}, 'description': 'Info items to ADD to the booking (existing ones are untouched).'}}}
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.
可能执行破坏性操作
输入模式
{'type': 'object', '$schema': 'https://json-schema.org/draft/2020-12/schema', 'required': ['roomId', 'from', 'to'], 'properties': {'to': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Last date, YYYY-MM-DD.'}, 'from': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'First date, YYYY-MM-DD.'}, 'price1': {'type': ['number', 'null'], 'description': 'Calendar price1 for these dates. null removes it.'}, 'price2': {'type': ['number', 'null'], 'description': 'Calendar price2 for these dates. null removes it.'}, 'price3': {'type': ['number', 'null'], 'description': 'Calendar price3 for these dates. null removes it.'}, 'price4': {'type': ['number', 'null'], 'description': 'Calendar price4 for these dates. null removes it.'}, 'price5': {'type': ['number', 'null'], 'description': 'Calendar price5 for these dates. null removes it.'}, 'price6': {'type': ['number', 'null'], 'description': 'Calendar price6 for these dates. null removes it.'}, 'price7': {'type': ['number', 'null'], 'description': 'Calendar price7 for these dates. null removes it.'}, 'price8': {'type': ['number', 'null'], 'description': 'Calendar price8 for these dates. null removes it.'}, 'price9': {'type': ['number', 'null'], 'description': 'Calendar price9 for these dates. null removes it.'}, 'roomId': {'type': 'integer', 'maximum': 9007199254740991, 'description': 'The room id.', 'exclusiveMinimum': 0}, 'maxStay': {'type': 'integer', 'maximum': 364, 'minimum': 1}, 'minStay': {'type': 'integer', 'maximum': 365, 'minimum': 1}, 'price10': {'type': ['number', 'null'], 'description': 'Calendar price10 for these dates. null removes it.'}, 'price11': {'type': ['number', 'null'], 'description': 'Calendar price11 for these dates. null removes it.'}, 'price12': {'type': ['number', 'null'], 'description': 'Calendar price12 for these dates. null removes it.'}, 'price13': {'type': ['number', 'null'], 'description': 'Calendar price13 for these dates. null removes it.'}, 'price14': {'type': ['number', 'null'], 'description': 'Calendar price14 for these dates. null removes it.'}, 'price15': {'type': ['number', 'null'], 'description': 'Calendar price15 for these dates. null removes it.'}, 'price16': {'type': ['number', 'null'], 'description': 'Calendar price16 for these dates. null removes it.'}, 'numAvail': {'type': 'integer', 'maximum': 9007199254740991, 'minimum': -9007199254740991, 'description': 'Units available per day.'}, 'override': {'enum': ['none', 'blackout', 'exception', 'noCheckIn', 'noCheckOut', 'noCheckInOrCheckOut'], 'type': 'string'}, 'multiplier': {'type': 'number', 'maximum': 100, 'minimum': 0.1}}}
已添加
beds24_update_room_calendar
2026年10月2日 02:40
已添加
beds24_mark_messages_read
2026年10月2日 02:40
已添加
beds24_send_booking_message
2026年10月2日 02:40
已添加
beds24_update_booking
2026年10月2日 02:40
已添加
beds24_create_booking
2026年10月2日 02:40
已添加
beds24_list_airbnb_reviews
2026年10月2日 02:40
已添加
beds24_list_booking_com_reviews
2026年10月2日 02:40
已添加
beds24_list_fixed_prices
2026年10月2日 02:40
已添加
beds24_get_room_calendar
2026年10月2日 02:40
已添加
beds24_get_unit_bookings
2026年10月2日 02:40
已添加
beds24_get_room_availability
2026年10月2日 02:40
已添加
beds24_get_room_offers
2026年10月2日 02:40
已添加
beds24_list_booking_invoices
2026年10月2日 02:40
已添加
beds24_list_booking_messages
2026年10月2日 02:40
已添加
beds24_get_booking
2026年10月2日 02:40
已添加
beds24_list_bookings
2026年10月2日 02:40
已添加
beds24_list_properties
2026年10月2日 02:40
已添加
beds24_get_token_details
2026年10月2日 02:40