Skip to content

Docs / All tools / Base tools

booking_com.reserve_stay

Open a Booking.com reservation page and fill in the details up to the payment step.

40 credits. Per reservation. 0 when cancelled.

Example prompt

Send this to your AI app when Heelo is connected:

Fill this Booking.com reservation checkout: https://www.booking.com/...

Input fields

FieldTypeDescription
querystringNatural-language reservation request or field update.
reservation_urlstringBooking.com reservation/checkout URL after a stay and room are selected.
first_namestring
last_namestring
emailstring
phonestring
countrystring
cardholder_namestring
billing_addressstring
billing_citystring
billing_zipstring
headlessboolean
session_idstring
messagestringFollow-up answer for the current requested field.

Output fields

The fields in data when status is success.

FieldType
phasestring
answerstring
statusobject
collectedobject
questionobject

Code

The call with the input fields that the tool needs. Replace each word in capitals, such as RESERVATION_URL. Set HEELO_API_KEY to your API key.

import os
import requests

response = requests.post(
    "https://toolsprimitives.uk/v1/tools/booking_com.reserve_stay/invoke",
    headers={"Authorization": f"Bearer {os.environ['HEELO_API_KEY']}"},
    json={"input": {
        "reservation_url": "RESERVATION_URL",
    }},
    timeout=120,
)
response.raise_for_status()
print(response.json())