Create booking
create_bookingReserve an offer for the user: re-prices the offer, holds availability and creates an order awaiting payment. Ask the user to confirm the offer, travellers and contact details first. When the result is price_changed, show the new price and call accept_price_change only if the user agrees.
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": {
"vertical": "<vertical>",
"externalId": "<externalId>",
"travellers": "<travellers>",
"contact": "<contact>",
"idempotencyKey": "<idempotencyKey>"
},
"name": "create_booking"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| contact | Yes | Contact details for booking confirmations. | |
| endDate | No | End date of the service, YYYY-MM-DD, when the offer does not fix it. | |
| currency | No | Charge currency as an ISO 4217 code. Defaults to PLN. | |
| vertical | Yes | Service type. | |
| startDate | No | Start date of the service, YYYY-MM-DD, when the offer does not fix it. | |
| couponCode | No | Discount code. | |
| externalId | Yes | Offer identifier (externalId) returned by a search tool. | |
| travellers | Yes | People travelling or insured. The first one is the lead traveller and the main driver. | |
| vehiclePlate | No | Vehicle registration number. Required for parking. | |
| idempotencyKey | Yes | Unique key of 8 to 100 characters that you generate once per attempt. Repeating it never creates a duplicate. | |
| insuranceAddon | No | Optional travel insurance variant added to the booking. | |
| driverLicenseYears | No | Years the main driver has held a driving licence. |