create_booking
Create a booking for a tourism service.
Pass children_count whenever the party includes children, and
quoted_total_minor with the total you last quoted, so a price that moved
between the quote and the booking is refused rather than silently charged.
IMPORTANT: This only RESERVES the booking — it is NOT confirmed until paid.
Ask the traveller for their email and phone. Show the exact held email and phone
values and ask for a correction if either is wrong; never guess or auto-apply a
suggestion.
Verification: if the response is contact_verification_required, a six-digit
code has been emailed to the traveller. Ask them to read it out, then call
the SAME tool again, create_booking, with the SAME arguments you sent the
first time plus verification_code=<code>. That second call IS the submission
of the code; there is no separate verify tool, and there is nothing for the
traveller to do on soley.travel. The response repeats this in next_action
and hands your own arguments back in retry_with. Never tell the traveller
that no action exists for the code.
Multi-stop trips: if the tourist is booking several operators in one
trip (e.g. hotel + tour + activity), call create_booking for EACH leg
FIRST. Do NOT call get_payment_link between bookings — that produces
multiple separate links. Leave trip_token empty on the first leg; the
response returns a 'trip_token' — pass that same token on every later leg
of this trip. Once every leg is reserved, call get_payment_link ONCE with
any one booking_reference; the server bundles exactly this trip's legs
(by trip_token) into a single consolidated payment link.
Never tell the user a booking is confirmed until payment is complete.
The response transaction_mode is demo, sandbox, or live. If demo_notice is
present, relay it exactly; do not describe a sandbox booking as live or
chargeable.
Requires OAuth2 authentication.
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": {
"operator_id": "<operator_id>",
"service_id": "<service_id>",
"check_in": "<check_in>",
"check_out": "<check_out>",
"guest_name": "<guest_name>",
"guest_phone": "<guest_phone>",
"guest_count": "<guest_count>",
"guest_email": "<guest_email>"
},
"name": "create_booking"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| channel | No | Verification delivery chosen by the traveller. Email is the default. SMS falls back to email when Twilio Verify is unavailable. | |
| check_in | Yes | Arrival date in ISO format (YYYY-MM-DD), e.g. '2026-06-15'. | |
| check_out | Yes | Departure date in ISO format (YYYY-MM-DD), e.g. '2026-06-18'. | |
| time_slot | No | Optional time slot in HH:MM format, e.g. '15:00'. Required for scheduled services like Lava Show. | |
| guest_name | Yes | Full name of the guest making the booking. | |
| service_id | Yes | Service identifier for a specific room type, tour, or activity. Obtain from get_services using the operator_id. | |
| trip_token | No | Trip token that groups the legs of ONE trip for a single payment. Leave EMPTY on the first booking of a trip — the response returns a fresh 'trip_token'. Pass that SAME token on every subsequent create_booking for the same trip so the consolidated payment link covers exactly this trip and nothing else. | |
| guest_count | Yes | The TOTAL number of travellers, including any children. For two adults and one child pass guest_count=3, adults_count=2, children_count=1, NOT guest_count=2. Getting this wrong books too few seats and the operator's manifest is short a person on the day. | |
| guest_email | Yes | Guest email address for booking confirmation, e.g. 'tourist@example.com'. | |
| guest_phone | Yes | Guest phone number in international format, e.g. '+3548001234'. Icelandic numbers: '+354' followed by 7 digits. | |
| operator_id | Yes | Unique operator slug, e.g. 'fosshotel-reykjavik' or 'arctic-adventures'. Obtain from search_operators. Do not guess — always look up first. | |
| adults_count | No | How many of guest_count are adults. Optional, but always pass it: when given, adults_count + children_count must equal guest_count, and the call is refused if it does not, rather than booking the wrong party. | |
| children_count | No | How many of guest_count are children. Pass this whenever any traveller is a child and the service lists a child price. | |
| quoted_currency | No | Currency of quoted_total_minor, e.g. 'ISK'. Defaults to the service's own settlement currency. | |
| special_requests | No | Optional guest requests, e.g. 'late check-in' or 'ground floor room'. Do not include card numbers, identity documents, or medical records. | |
| verification_code | No | Six-digit code the traveller received after create_booking returned contact_verification_required. Submitting the code IS calling the SAME tool again: create_booking, with the SAME arguments you sent the first time, plus verification_code=<code>. There is no separate verify tool and nothing for the traveller to do on soley.travel. The error response repeats this in next_action and hands your own arguments back in retry_with; follow them. | |
| quoted_total_minor | No | The total you last showed the traveller, in minor units, copied from check_availability's price_total_amount_minor or get_price_quote's total_amount_minor. If it no longer matches the server's price the booking is refused instead of charging a different amount. Always pass it when you have quoted a price. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||