> For the complete documentation index, see [llms.txt](https://support.holidayhero.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://support.holidayhero.com/integrations/pms-platforms/amenitiz.md).

# Amenitiz

<figure><img src="/files/WGgJan4GGbIAl5A4Ztqp" alt=""><figcaption></figcaption></figure>

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 <a href="#listings" id="listings"></a>

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 <a href="#booking-sync" id="booking-sync"></a>

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 <a href="#initial-sync" id="initial-sync"></a>

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 <a href="#guides" id="guides"></a>

<details open>

<summary>How to connect Amenitiz to HolidayHero?</summary>

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.

</details>

<details open>

<summary>Where do I find my access token and hotel UUID?</summary>

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.

</details>

<details open>

<summary>How often does the sync run?</summary>

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.

</details>

<details open>

<summary>What booking statuses are imported?</summary>

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.

</details>

<details>

<summary>How is the booking value split when a booking covers several rooms?</summary>

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.

</details>

<details open>

<summary>What if Amenitiz returns a temporary error?</summary>

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.<br>

</details>

***

**HolidayHero Permissions**

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

<table><thead><tr><th width="259">Permission</th><th>Description</th></tr></thead><tbody><tr><td><code>reservation.create</code></td><td>The integration will be able to create reservations imported from Amenitiz.</td></tr><tr><td><code>reservation.update</code></td><td>The integration will be able to update reservations when they change in Amenitiz.</td></tr><tr><td><code>reservation.cancel</code></td><td>The integration will be able to cancel reservations when they are cancelled in Amenitiz.</td></tr><tr><td><code>listing.read</code></td><td>The integration will be able to read your listings to match them to Amenitiz rooms.</td></tr><tr><td><code>invitation.create</code></td><td>The integration will be able to invite guests to a reservation.</td></tr><tr><td></td><td></td></tr></tbody></table>

**HolidayHero Webhooks**

<table><thead><tr><th width="260">Webhook</th><th>Description</th></tr></thead><tbody><tr><td><code>installation.uninstalled</code></td><td>The integration detects when it has been uninstalled and cleans up all associated data.</td></tr><tr><td><code>listing.deleted</code></td><td>Removes connected listings once the listing is deleted. </td></tr></tbody></table>

***

## Agent Instructions: Querying This Documentation <a href="#agent-instructions-querying-this-documentation" id="agent-instructions-querying-this-documentation"></a>

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:

```
GET https://support.holidayhero.com/integrations/pms-platforms/amenitiz.md?ask=<question>
```

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.
