Confirm Booking via Active Hold
create_bookingFinalize and confirm a reservation in the property's PMS using an active 15-minute hold (`hold_id`).
The property owner is the merchant of record with zero OTA intermediaries.
When to use:
- Use after creating an active hold via `create_hold` to commit the reservation into the PMS (when `payment_required=False` or when authenticated with a tenant API key).
When NOT to use:
- Do NOT call `create_booking` without first locking inventory via `create_hold`.
- When `create_hold` returns `payment_required=True` on a public session, direct the guest to the `checkout_url` instead of calling `create_booking` before payment.
Args:
hold_id: Hold ID from create_hold (must be active, not expired)
guest_name: Full name of primary guest
guest_email: Guest email
guest_phone: Guest phone (international format, e.g. +306912345678)
idempotency_key: Unique key from caller — prevents double-booking on retry
notes: Optional special requests
Returns:
JSON object with `success`, `booking_id`, `pms_booking_id`, `unit_id`, `check_in`, `check_out`, `status`, and confirmation dispatch flags.
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": {
"hold_id": "<hold_id>",
"guest_name": "<guest_name>",
"guest_email": "<guest_email>",
"guest_phone": "<guest_phone>",
"idempotency_key": "<idempotency_key>"
},
"name": "create_booking"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| notes | No | Optional special requests, arrival notes, or flight details. | |
| hold_id | Yes | Active 15-minute inventory hold ID returned by `create_hold`. | |
| guest_name | Yes | Full legal name of the lead guest. | |
| guest_email | Yes | Primary guest email address for confirmation and pre-arrival check-in. | |
| guest_phone | Yes | Guest phone/WhatsApp number in international E.164 format (e.g. '+306912345678'). | |
| idempotency_key | Yes | Caller-generated unique key (UUID or string) to guarantee idempotency and prevent duplicate bookings on retry. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |