For the complete documentation index, see llms.txt. This page is also available as Markdown.

Amenitiz

Amenitiz is an all-in-one property management system for independent hotels, guesthouses, and bed and breakfasts, widely used across France, Italy, Spain, and Portugal.

With the Amenitiz integration, you connect your Amenitiz property management system to your HolidayHero workspace. The integration polls the Amenitiz Vendor API on a regular schedule, pulling your most recently updated bookings into HolidayHero so that messaging, tasks, and smart devices run on the same set of reservations as your front desk. When a new booking arrives, the guest is automatically invited to the HolidayHero guest app.

Listings

Match each HolidayHero listing to the corresponding Amenitiz room on the Listings tab. The dropdown shows every individual room in your property, not the room types, so each physical room maps to exactly one HolidayHero listing. Once matched, any booking assigned to that room is automatically synced into the matched listing.

Booking sync

The integration polls Amenitiz every fifteen minutes for bookings updated in the last two days. Each booking is individually queued and synced to HolidayHero. Confirmed and modified bookings are imported, along with checked in, checked out, and completed ones. Cancelled bookings cancel the corresponding HolidayHero reservation automatically.

A booking that covers more than one room becomes one HolidayHero reservation per room, so each room shows up on its own listing.

Please note: Amenitiz reports a single total for the whole booking and never a price per room. When a booking covers several rooms, HolidayHero divides that total evenly across them. Your workspace total stays correct to the cent, but the amount on an individual reservation is an even share rather than what that particular room was actually sold for. See the guide below for the detail.

The following guest details are synced when available: first name, last name, email address, phone number, and language. When the booker has no name on the booking, the first guest on the room is used instead.

Initial sync

When you first activate the integration, an initial sync imports bookings with check-in dates from roughly three weeks ago through the next three months, so your HolidayHero calendar is populated from day one without dragging in stays that finished long ago. From then on the integration keeps checking Amenitiz for new and changed bookings, so anything further ahead arrives as soon as it is booked or updated.


Guides

How to connect Amenitiz to HolidayHero?
  1. Install the Amenitiz integration from the HolidayHero App Store.

  2. Go to Settings inside the integration and enter your Amenitiz Vendor API access token and your hotel UUID.

  3. Click Save, then click Test Connection. HolidayHero reads your property from Amenitiz and shows the property name when the credentials work.

  4. On the Listings tab, match each HolidayHero listing to the corresponding Amenitiz room.

  5. Go to Home and activate the integration using the toggle.

  6. Click Save. The first sync runs immediately.

Amenitiz issues the access token and the hotel UUID to you directly. If you do not have them, contact Amenitiz support and ask for Vendor API access.

Where do I find my access token and hotel UUID?

Both are issued by Amenitiz. Contact Amenitiz support and ask them to enable Vendor API access for your property. They send you a long access token and the hotel UUID it belongs to. The UUID looks like 1e0d740f-75d5-4535-89da-5fbadcba157d, not a plain number.

The token does not expire, so you only enter it once. If it ever stops working, ask Amenitiz for a new one and paste it on the Settings page.

How often does the sync run?

The integration polls Amenitiz for recently updated bookings every fifteen minutes. Room data is refreshed less frequently. There is no manual trigger, but you can check the Logs tab to see when the last sync ran and whether it succeeded.

What booking statuses are imported?

The integration imports bookings with the following statuses: confirmed, modified, checked in, checked out, and completed. Bookings with other statuses are skipped and logged. Cancelled bookings are not imported as new reservations; instead, if a matching reservation already exists in HolidayHero, it is cancelled automatically.

How is the booking value split when a booking covers several rooms?

Amenitiz sends HolidayHero one total for the whole booking and does not break it down per room. Because each room becomes its own reservation in HolidayHero, that total is divided evenly across them.

The division is exact to the cent. Any leftover cents are given to the first rooms, so the shares always add back up to the original booking total. A booking of 100.00 across three rooms becomes 33.34, 33.33 and 33.33. A booking of 286.00 across seven rooms becomes 40.86 on five reservations and 40.85 on the other two.

Two things worth knowing:

  • The figure on a single reservation is an even share, not the real price of that room. Your totals across the workspace are correct, but treat a per room amount as an estimate.

  • If Amenitiz has not assigned a room to part of the booking yet, that room has no reservation in HolidayHero and its share is not counted anywhere until the room is assigned. Assign the room in Amenitiz and the next sync picks it up.

If you need the exact price per room, that figure lives in Amenitiz and is not something the Vendor API shares.

What if Amenitiz returns a temporary error?

Transient errors such as timeouts, gateway errors, and 5xx responses are retried automatically by the queue. Permanent errors are written to the Logs tab so you can investigate. An authentication error means the access token is no longer valid, so it is reported on the Logs tab rather than retried.


HolidayHero Permissions

Each integration has its own set of permissions. Please find below what this integration will be able to do.

Permission
Description

reservation.create

The integration will be able to create reservations imported from Amenitiz.

reservation.update

The integration will be able to update reservations when they change in Amenitiz.

reservation.cancel

The integration will be able to cancel reservations when they are cancelled in Amenitiz.

listing.read

The integration will be able to read your listings to match them to Amenitiz rooms.

invitation.create

The integration will be able to invite guests to a reservation.

HolidayHero Webhooks

Webhook
Description

installation.uninstalled

The integration detects when it has been uninstalled and cleans up all associated data.

listing.deleted

Removes connected listings once the listing is deleted.


Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the ask query parameter:

The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.

Last updated