Create booking request
create_booking_requestWHEN: use it only after the traveller has (1) picked ONE category and dates, (2) given name, email and phone, and (3) EXPLICITLY accepted the cancellation policy — never set accepted_terms: true on your own. WHAT IT RETURNS: booking_id, checkout_url (a page on beachvalencia.com that shows the breakdown and asks the guest to tick the cancellation policy BEFORE jumping to Stripe), expires_at (ISO 8601, ~30 min in the future), hold_minutes: 30, total/nightly EUR, nights, guests, property, deposit, cancellation summary, terms_url, idempotent (true if a prior request with the same category+dates+pax+email was replayed), and a message ready to show to the guest. PAYMENT: always on Stripe, hosted at beachvalencia.com. The agent NEVER charges the guest itself. If the hold expires without payment, the unit is released automatically and a new request is needed. The price is the public rate (no member discount, no coupon codes — if the guest has a code, they apply it on the web). IDEMPOTENCY: a replay with the same category, dates, pax and email returns the same booking. EXAMPLE: {"id":"G4","check_in":"2027-05-22","check_out":"2027-05-27","adults":4,"guest_name":"Ada Lovelace","guest_email":"ada@example.com","guest_phone":"+34612345678","language":"en","accepted_terms":true}.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"id": "<id>",
"check_in": "<check_in>",
"check_out": "<check_out>",
"adults": "<adults>",
"guest_name": "<guest_name>",
"guest_email": "<guest_email>",
"guest_phone": "<guest_phone>",
"language": "<language>",
"accepted_terms": "<accepted_terms>"
},
"name": "create_booking_request"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Property/type ID (G1..G6 or G4B). | |
| adults | Yes | Number of adults. | |
| check_in | Yes | Arrival date YYYY-MM-DD (Europe/Madrid). | |
| children | No | Optional list of children ages. Only the count is used to size the property. | |
| language | Yes | Language for the confirmation email and error messages. | |
| check_out | Yes | Departure date YYYY-MM-DD (Europe/Madrid); strictly after check_in. | |
| guest_name | Yes | Guest's full name. | |
| guest_email | Yes | Guest's email — receives the payment link and confirmation. | |
| guest_phone | Yes | Guest's phone number, including country code. | |
| accepted_terms | Yes | Must be true. The agent confirms the traveller accepted the cancellation policy and the terms and conditions. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| guests | Yes | ||
| nights | Yes | ||
| deposit | Yes | ||
| message | Yes | ||
| currency | Yes | ||
| property | Yes | ||
| breakdown | No | ||
| terms_url | Yes | ||
| booking_id | Yes | ||
| expires_at | Yes | ||
| idempotent | Yes | ||
| cancellation | Yes | ||
| checkout_url | Yes | ||
| hold_minutes | Yes | ||
| nightly_avg_eur | No | ||
| total_price_eur | Yes | ||
| cancellation_details_url | Yes |