beds24_create_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.

destructive

Argument	Type	Description
tax	number
city	string
lang	string	Guest language, 2-letter code, e.g. en.
email	string
notes	string	Internal host notes.
phone	string
price	number	Total booking price.
state	string
title	string	Guest title, e.g. Mr, Ms.
mobile	string
roomId*	integer	Room (room type) id.
status	string	Booking status.
unitId	integer	Specific unit within the room type.
address	string
arrival*	string	Arrival date, YYYY-MM-DD.
company	string
country	string	Free text country.
deposit	number
comments	string	Guest comments.
country2	string	2-letter country code, e.g. DE.
flagText	string
lastName	string
numAdult	integer	Number of adults.
numChild	integer	Number of children.
postcode	string
departure*	string	Departure (check-out) date, YYYY-MM-DD.
firstName	string
flagColor	string	Flag colour, 6-character hex (e.g. ff0000) or empty string to clear.
reference	string	Your own reference.
notifyHost	boolean	Email the host a booking confirmation.
arrivalTime	string	Expected arrival time (free text).
notifyGuest	boolean	Email the guest a booking confirmation.
assignBooking	boolean	Let Beds24 assign the first free unit / room using room dependency settings.
checkAvailability	boolean	Do not save the booking if the room has no availability. Recommended.

Input schema (JSON)

{
  "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

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>.

read-only

Argument	Type	Description
bookingId*	integer	The booking id.

Input schema (JSON)

{
  "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

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.

read-only

Argument	Type	Description
page	integer	Page number beyond the first (2, 3, ...). Check pages.nextPageExists in the previous response.
endDate	string	Last night (day before check-out), YYYY-MM-DD.
roomIds	array	One or more room ids.
startDate	string	First night, YYYY-MM-DD.
propertyIds	array	One or more property ids.

Input schema (JSON)

{
  "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

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.

read-only

Argument	Type	Description
page	integer	Page number beyond the first (2, 3, ...). Check pages.nextPageExists in the previous response.
endDate*	string	Last date, YYYY-MM-DD.
roomIds	array	One or more room ids.
startDate*	string	First date, YYYY-MM-DD.
propertyIds	array	One or more property ids.
includePrices	boolean
includeMaxStay	boolean
includeMinStay	boolean
includeChannels

beds24_get_room_offers

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.

read-only

Argument	Type	Description
page	integer	Page number beyond the first (2, 3, ...). Check pages.nextPageExists in the previous response.
arrival*	string	Arrival date, YYYY-MM-DD.
roomIds	array	One or more room ids.
offerIds	array	One or more offer ids.
agentCode	string
departure*	string	Departure date, YYYY-MM-DD.
numAdults*	integer	Number of adults.
numChildren	integer
propertyIds	array	One or more property ids.

beds24_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.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

beds24_get_unit_bookings

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.

read-only

Argument	Type	Description
page	integer	Page number beyond the first (2, 3, ...). Check pages.nextPageExists in the previous response.
endDate	string	Last night, YYYY-MM-DD.
roomIds	array	One or more room ids.
startDate	string	First night, YYYY-MM-DD.
propertyIds	array	One or more property ids.

Input schema (JSON)

{
  "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

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.

read-only

Argument	Type	Description
roomId*	integer	The Beds24 room id linked to the Airbnb listing.

Input schema (JSON)

{
  "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

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.

read-only

Argument	Type	Description
from*	string	Reviews made on or after this date, YYYY-MM-DD.
propertyId*	integer	The property id.

Input schema (JSON)

{
  "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 invoices and their line items (charges and payments) for bookings. Requires the bookings-financial scope. Beds24 marks this endpoint Alpha. Beds24: GET /bookings/invoices.

read-only

Argument	Type	Description
page	integer	Page number beyond the first (2, 3, ...). Check pages.nextPageExists in the previous response.
bookingIds	array	One or more booking ids.

Input schema (JSON)

{
  "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

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.

read-only

Argument	Type	Description
page	integer	Page number beyond the first (2, 3, ...). Check pages.nextPageExists in the previous response.
filter	string
maxAge	integer	Only messages from the last N days.
source	string	Only messages from one side.
roomIds	array	One or more room ids.
masterIds	array	One or more group master booking ids.
bookingIds	array	One or more booking ids.
messageIds	array	One or more message ids.
propertyIds	array	One or more property ids.

beds24_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.

read-only

Argument	Type	Description
page	integer	Page number beyond the first (2, 3, ...). Check pages.nextPageExists in the previous response.
filter	string
status	array	Statuses to include. Defaults to all except cancelled.
arrival	string	Exact arrival date.
channel	string	Only bookings from this channel.
roomIds	array	One or more room ids.
arrivalTo	string	Date, YYYY-MM-DD.
departure	string	Exact departure date.

beds24_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.

read-only

Argument	Type	Description
page	integer	Page number beyond the first (2, 3, ...). Check pages.nextPageExists in the previous response.
roomIds	array	One or more room ids.
propertyIds	array	One or more property ids.
fixedPriceIds	array	One or more fixed price ids.
includeRateCodes	boolean

Input schema (JSON)

{
  "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 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.

read-only

Argument	Type	Description
page	integer	Page number beyond the first (2, 3, ...). Check pages.nextPageExists in the previous response.
roomIds	array	One or more room ids.
propertyIds	array	One or more property ids.
includeTexts	array	Which descriptive texts to include.
includeOffers	boolean	Include offers per room.
includeAllRooms	boolean	Include every room type of each property.
includePictures	boolean
includeLanguages	array	Languages for texts, e.g. ["en"] or ["all"].
includePriceRules

beds24_mark_messages_read

Mark one or more booking messages as read (or unread with read=false). Beds24: POST /bookings/messages with [{ id, read }].

destructive

Argument	Type	Description
read	boolean	true (default) = read, false = unread.
messageIds*	array	Message ids.

Input schema (JSON)

{
  "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 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.

destructive

Argument	Type	Description
source	string	host (to the guest, default) or internalNote (private).
message*	string	Message text.
bookingId*	integer	The booking id.

Input schema (JSON)

{
  "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

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.

destructive

Argument	Type	Description
tax	number
city	string
lang	string	Guest language, 2-letter code, e.g. en.
email	string
notes	string	Internal host notes.
phone	string
price	number	Total booking price.
state	string
title	string	Guest title, e.g. Mr, Ms.
mobile	string

beds24_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.

destructive

Argument	Type	Description
to*	string	Last date, YYYY-MM-DD.
from*	string	First date, YYYY-MM-DD.
price1	number \| null	Calendar price1 for these dates. null removes it.
price2	number \| null	Calendar price2 for these dates. null removes it.
price3	number \| null	Calendar price3 for these dates. null removes it.
price4	number \| null	Calendar price4 for these dates. null removes it.
price5	number \| null	Calendar price5 for these dates. null removes it.
price6	number \| null

Beds24 MCP by usefulapi

Try it

beds24_create_booking Destructive

Beds24 MCP by usefulapi

Try it

beds24_create_booking Destructive

Tools (18)