hemmabo_booking_create
Create a pending booking when a signed VRP direct booking URL is unavailable. Ensures the booking is recorded for host confirmation without requiring online payment.
Instructions
Create a pending direct booking without online payment for configured non-VRP fallback deployments. Use only after explicit user confirmation, with a propertyId from search, and only when no signed VRP direct_booking_url is available. For signed VRP offers, route to the signed host-domain URL instead. Requires Authorization: Bearer token (MCP_API_KEY or OAuth). Writes a pending booking server-side; not idempotent — check hemmabo_booking_status before retrying on timeout. Rate-limited per token. The booking is identified by propertyId + the checkIn/checkOut range + guests; guestName and guestEmail are required for host confirmation, while guestPhone is optional for check-in coordination.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| guests | Yes | Total guest count as a positive integer (e.g. 2, 4, 6). Used for capacity filtering and staircase pricing tiers. Properties with maxGuests below this value are excluded from search results. | |
| checkIn | Yes | Arrival date in ISO 8601 calendar format YYYY-MM-DD (e.g. '2026-07-15'). Must be today or later in the property's timezone. Must be strictly before checkOut; together they define the stay length used for pricing and availability. | |
| checkOut | Yes | Departure date in ISO 8601 calendar format YYYY-MM-DD (e.g. '2026-07-22'). Must be strictly after checkIn on the same calendar. The guest does not stay the departure night. | |
| guestName | Yes | Primary guest full name as plain text (e.g. 'Anna Svensson'). Stored on the booking for host confirmation; use the name the guest provided. | |
| guestEmail | Yes | Primary guest email in RFC 5322 format (e.g. 'anna@example.com'). Used for booking confirmation and host contact; must be deliverable. | |
| guestPhone | No | Primary guest phone in E.164 format with country code (e.g. '+46701234567'). Optional; omit when unknown. Recommended for check-in coordination. | |
| propertyId | Yes | Stable property UUID from hemmabo_search_properties (e.g. '550e8400-e29b-41d4-a716-446655440000'). Pass the exact UUID string — never a property name, host domain, or booking URL. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Present only when isError=true. | |
| guests | No | ||
| nights | No | ||
| status | Yes | Host-node booking status. 'completed' is a protocol compatibility output only, not a status this tool writes. | |
| checkIn | No | ||
| checkOut | No | ||
| currency | No | ||
| bookingId | Yes | Persistent booking UUID. Use for status/cancel/reschedule. | |
| createdAt | No | ||
| priceType | No | Pricing mode used (federation/gap_night/package_*). | |
| propertyId | No | ||
| totalPrice | No | Final price written to the booking. | |
| packageApplied | No | ||
| gapDiscountPercent | No | ||
| federationDiscountPercent | No |