Create 15-Minute Inventory Hold & Stripe Checkout
create_holdPlace an exclusive 15-minute inventory hold on a villa (`unit_id`) and generate a direct Stripe Checkout URL.
Locks the property's calendar for 15 minutes so no conflicting booking can occur while the guest completes payment.
When to use:
- Use when the guest is ready to lock a specific `unit_id` and dates after reviewing `search_properties` or `get_rate_details`.
- Always call `create_hold` before calling `create_booking`.
When NOT to use:
- Do NOT use while browsing or comparing properties—use `search_properties` or `get_rate_details` instead.
- If the guest decides not to proceed after a hold is created, call `cancel_hold` (not `cancel_booking`) to release the hold.
Args:
unit_id: The unit_id returned by search_properties
check_in: Arrival date YYYY-MM-DD
check_out: Departure date YYYY-MM-DD
guests: Number of guests
guest_email: Primary guest email address to bind the reservation hold
Returns:
JSON object with `hold_id`, `expires_at` timestamp, `payment_required` flag, `next_step`, and direct Stripe `checkout_url`.
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": {
"unit_id": "<unit_id>",
"check_in": "<check_in>",
"check_out": "<check_out>",
"guests": "<guests>",
"guest_email": "<guest_email>"
},
"name": "create_hold"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| guests | Yes | Total number of guests staying at the property. | |
| unit_id | Yes | Unique property unit identifier (`unit_id` returned by `search_properties`). | |
| check_in | Yes | Arrival date in ISO 8601 format (YYYY-MM-DD). | |
| check_out | Yes | Departure date in ISO 8601 format (YYYY-MM-DD). | |
| guest_email | Yes | Primary guest email address to bind the 15-minute inventory hold and payment receipt. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |