# MEWS

<figure><img src="/files/FwpCMOVPBlDOZZLsDSCR" alt=""><figcaption><p>HolidayHero MEWS Integration</p></figcaption></figure>

MEWS is a cloud-based property management system designed for modern hotels and hostels that prioritize automation and guest-centric experiences. Known for its open API and robust integration ecosystem, MEWS offers tools for reservations, housekeeping, payments, and guest messaging in a single platform. Its focus on contactless check-in, real-time dashboards, and seamless third-party connectivity makes it ideal for tech-forward properties seeking operational efficiency and flexibility. MEWS empowers hotel teams to eliminate repetitive tasks and deliver exceptional service with minimal friction.

***

**Category:**  `PMS`

***

#### MEWS PMS Integration <a href="#mews-pms-integration" id="mews-pms-integration"></a>

With the MEWS integration, you connect your Mews property management system to your HolidayHero workspace. The integration pulls every Mews reservation on the services and channels you choose into HolidayHero, so the rest of your operation — messaging, tasks, smart devices, reporting — runs on the same set of bookings as your front desk. When a new reservation lands, the guest is automatically invited to the HolidayHero guest app.

#### Listings & channel filtering <a href="#listings--channel-filtering" id="listings--channel-filtering"></a>

Match each HolidayHero listing to a Mews **resource** (a single room/unit) or a Mews **resource category** (a room type). Use the resource category mapping when you let Mews assign the specific room at check-in; use the resource mapping when the room is fixed. Optionally restrict which reservations are imported by listing the exact channel manager names you want to allow.

#### Guest check-in sync (HolidayHero → MEWS) <a href="#guest-check-in-sync-holidayhero--mews" id="guest-check-in-sync-holidayhero--mews"></a>

When a guest completes their online check-in inside HolidayHero, their profile details and identity-document data are pushed back into the matched Mews customer record automatically. The integration uses Mews's modern identity-documents endpoints — the deprecated `Customer.Passport` field is **not** used.

What gets synced: name, email, phone, date of birth, nationality, sex, postal address, and the guest's passport / national ID / driver's license (number, issuance, expiry, issuing country). Each guest on a reservation is matched to the right Mews customer (by email → full name → primary guest fallback), so multi-guest bookings stay accurate.

{% hint style="info" %}
The integration never overwrites a Mews field with an empty value. If HolidayHero doesn't have a value for a given field, that field is left untouched on the Mews customer record — so existing front-desk data stays safe.
{% endhint %}

#### Reservations tab <a href="#reservations-tab" id="reservations-tab"></a>

A dedicated **Reservations** tab inside the integration lists every reservation whose guest check-ins have been pushed to Mews. Each row shows a `synced / total guests` count, the last-synced timestamp, and direct deep-links into both HolidayHero and Mews. Click **View** to see exactly which guests are on file in Mews — pending or failed check-ins are deliberately hidden so the page reflects the real state of your Mews customer records.

***

#### Guides

<details>

<summary>How to integrate with mews? </summary>

**In MEWS**

1. Open the Mews Marketplace and request a Connector integration with HolidayHero.
2. Generate an **Access Token** for the integration.
3. Copy the Access Token.

**In HolidayHero**

1. Go to your desired [HolidayHero Workspace](https://admin.holidayhero.com/).
2. Go to [Integrations](https://admin.holidayhero.com/integrations).
3. Select **MEWS**.
4. Walk through the authentication process. You are installing an application on top of your HolidayHero workspace.
5. Inside the MEWS integration, go to **Settings**.
6. Paste the Access Token.
7. Hit **Save**.
8. Toggle on the **Services** you want to sync (hotels, apartments, hostels, …).
9. Optionally configure channel filtering.
10. Match your HolidayHero listings to Mews resources / resource categories on the **Listings** tab.
11. Activate the integration on the **Home** tab.

</details>

<details>

<summary>Ho do I enable guest check-in sync back to MEWS? </summary>

{% hint style="info" %}
First, ensure brand check-in is enabled. ([Read More](/the-basics/check-ins.md))
{% endhint %}

1. Open the MEWS integration in HolidayHero and go to **Settings**.
2. Switch on **Sync guest check-in details back to Mews**.
3. Pick a fallback **sex** for guests whose gender on HolidayHero is non-binary or unspecified. Mews only supports *Male* or *Female*, so this is the value used when the guest doesn't fit either. Leave it blank to keep the existing Mews value untouched in that case.
4. Hit **Save**.

From that point on, every completed (or updated) guest check-in in HolidayHero is pushed back to the matched Mews customer record automatically.

</details>

<details>

<summary>What happens if a check-in is deleted in HolidayHero?</summary>

The identity-document fields (passport number, issuance, expiration, issuing country) on the matching Mews customer are cleared. The Mews customer profile itself is not deleted — only the identity document data sourced from the deleted check-in is wiped.

</details>

<details>

<summary>How are guests to Mews customers on multi-guest reservations? </summary>

Each HolidayHero check-in is matched to a Mews customer in this order:

1. By **email** (case-insensitive) against the customers on the Mews reservation.
2. By **first + last name** match.
3. For the primary guest only: fall back to the reservation's main Mews `CustomerId`.

If none of these resolve, the integration logs a skipped activity entry on the Logs tab and does not overwrite any Mews customer.

</details>

<details>

<summary>Can I see what has been synced?</summary>

Yes. The **Reservations** tab inside the integration shows every reservation with at least one synced check-in, a `synced / total` counter, and a detail view that lists only the guests actually on file in Mews. Every sync (success, skip, failure) is also recorded on the **Logs** tab.

</details>

<details>

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

Transient API errors (timeouts, gateway errors, 5xx responses) are retried automatically by the queue before being marked as failed. Permanent errors are written to the Logs tab with the Mews response, so you can investigate.

</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 Mews.</td></tr><tr><td><code>reservation.update</code></td><td>The integration will be able to update reservations when they change in Mews.</td></tr><tr><td><code>reservation.cancel</code></td><td>The integration will be able to cancel reservations when they are cancelled in Mews.</td></tr><tr><td><code>listing.read</code></td><td>The integration will be able to read your listings to match them to Mews resources.</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><code>check_in.read</code></td><td>The integration will be able to read completed check-ins so they can be pushed back to Mews.</td></tr></tbody></table>

**HolidayHero Webhooks**

<table><thead><tr><th width="260">Webhook</th><th>Description</th></tr></thead><tbody><tr><td><code>listing.deleted</code></td><td>The integration detects when a listing has been removed and will remove the corresponding matched listings.</td></tr><tr><td><code>check_in.created</code></td><td>Triggers the sync of a newly completed guest check-in into the matched Mews customer record.</td></tr><tr><td><code>check_in.updated</code></td><td>Triggers a refresh of the Mews customer record when a guest updates their check-in details.</td></tr><tr><td><code>check_in.deleted</code></td><td>Clears the identity-document fields on the matching Mews customer when a check-in is removed in HolidayHero.</td></tr></tbody></table>

\ <br>


---

# 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:

```
GET https://support.holidayhero.com/integrations/pms-platforms/mews.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.