> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bubblav.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Lodgify

> Let guests check rental availability and prices, get a booking link with their dates, and look up their booking in chat

Connect a Lodgify API key so guests can ask your chatbot which rentals are free for their dates and what the stay costs. The chatbot shares a Lodgify checkout link with the dates filled in, and guests can look up an existing booking. BubblaV adds three chatbot tools. The chatbot cannot create, change, or cancel bookings.

## Why Connect Lodgify?

> [card] Availability and Price
>
> Check which room types are free for the guest's dates and guests, with the total price for the stay.

> [card] Booking Link
>
> Share a Lodgify checkout link with the dates filled in, so the guest books and pays on Lodgify.

> [card] Booking Lookup
>
> Guests look up status, dates, guests, total, paid, and amount due with their booking ID and verified email.

## Prerequisites

* A BubblaV website with edit access
* A Lodgify account with access to **Settings** → **Public API**
* Available on all plans

## Setup Steps

**1. Copy your API key**

In Lodgify, open **Settings** → **Public API** and copy your API key.

**2. Copy a booking link (optional)**

For booking links with the dates filled in, open the **Book Now** button on your Lodgify website and copy the address. It starts with `https://checkout.lodgify.com/`. Without it, the chatbot still answers, but asks guests to book on your website.

**3. Connect Lodgify**

Go to **Dashboard** → your website → **Integrations** → **Built-in Integrations** → **Lodgify** → **Connect**. Enter the **Lodgify API key** and, if you have it, the **Booking link (optional)**.

**4. BubblaV adds the tools**

BubblaV validates the key with a live API call and adds the three Lodgify tools to your chatbot.

**5. Test**

Ask the chatbot which rentals you have, then ask about availability for dates in the future.

## Available Tools After Connection

| Tool | Parameters and Behavior | Example Query |
| - | - | - |
| `lodgify_list_properties` | No parameters. Returns each rental with property ID, name, location, room types, price range, and a booking link. | "Which rentals do you have?" |
| `lodgify_check_availability` | Required `check_in`, `check_out` (YYYY-MM-DD) and `adults`. Optional `children` and `property_id`. Returns each free room type with its total price and a booking link with the dates filled in. The check does not hold the dates. | "Is a villa free from 10 to 14 February for 2 adults?" |
| `lodgify_get_booking` | Required `booking_id` and `customer_email`. The email must match the booking. Returns status, dates, rental, guest count, check-in and check-out time, total, paid, and amount due. | "What is the status of booking 12345678?" |

Guest names, phone numbers, and key codes are never shown in the chat.

## Limits

* Without a specific rental, the chatbot checks the first 10 rentals per question and asks which rental the guest wants.
* Stays can be up to 30 nights, and check-in up to one year ahead.
* Prices come from Lodgify and can change at checkout.
* The chatbot does not create, change, or cancel bookings.

## Email Verification

The chatbot asks visitors to verify their email with a 6-digit code before it shows booking data. You can turn this off with the **Require email verification** switch in the Tools section. It is on by default. See [Email Verification](https://docs.bubblav.com/user-guide/integrations/email-verification.md).

## Troubleshooting

> [accordion] Lodgify rejected this API key
>
> Copy the key again from Lodgify **Settings** → **Public API** and paste it in full.

> [accordion] Paste a Lodgify booking link that starts with [https://checkout.lodgify.com/](https://checkout.lodgify.com/)
>
> Open the **Book Now** button on your Lodgify website and copy the address, or leave **Booking link (optional)** empty.

> [accordion] The chatbot says no booking was found
>
> The booking ID and the email address must both match the booking. For privacy, the chatbot gives the same answer when the ID is unknown, the email does not match, or the booking was deleted.

> [accordion] Replace the key or booking link
>
> On the Lodgify integration card, click **Disconnect**, then click **Connect** and enter the new values.

> [accordion] Tools are missing after connecting
>
> If BubblaV shows **Connected, but the chatbot tools were not added**, or tools are missing, open the integration's **Configure** page and click **Sync Tools**. Then check that the Lodgify tools are enabled.

> [!NOTE]
>
> **Security**: Your API key is stored encrypted. A visitor must give both the booking ID and the matching verified email to see a booking.

## Next Steps

> [card] [Customize Your Widget](https://docs.bubblav.com/user-guide/widget-design.md)
>
> Match the chat widget to your website's appearance.

> [card] [Test Your Chatbot](https://docs.bubblav.com/user-guide/testing.md)
>
> Check availability answers and your configured website knowledge.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.