> For the complete documentation index, see [llms.txt](https://help.peoplevine.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.peoplevine.com/products/integrations-overview/setup-mews.md).

# How to Set Up Mews PMS

### Before you begin (Prerequisites)

* **Permissions**: You must be an **Administrator** or **Supervisor**. See: [How to Manage Users and Permissions](/products/control-panel-overview/admin-overview/manage-roles-permissions.md).
* **Mews account** with API access enabled.
* **Credentials from Mews**: Client Token, Access Token, and your Mews environment (Production or UAT). Your Mews implementation manager or support team can provide these.

> For full setup instructions including Mews-side configuration and field mapping details, see [Connect Mews and Peoplevine](https://docs.peoplevine.com/peoplevine-docs/peoplevine-connect) in Peoplevine Connect. The steps below cover the Peoplevine Control Panel side.

### Instructions

1. Navigate to [**AUTOMATE > Integrated Platforms**](https://control.peoplevine.com/admin_authenticate.aspx).

> **Note (Pro Dash):** Same path — **AUTOMATE > Integrated Platforms**.

2. Under **PMS Systems**, select **MEWS PMS**.
3. Enter the **Client Token** (provided by Peoplevine) and the **Access Token** (provided by Mews). A Service ID is not required.
4. Click **CONNECT**.
5. To run a sync, go to the **Sync Data** section:
   * Select the data type and direction.
   * Enter the date range: set the start date in **Sync Data Between** and the end date in the **And** field.
   * Click **SYNC WITH MEWS**.

### What Gets Synced

| Data                                 | Direction         | Notes                                                                                   |
| ------------------------------------ | ----------------- | --------------------------------------------------------------------------------------- |
| Member profiles (name, email, phone) | Peoplevine → Mews | Pushed on creation and updates; matched by email, phone, or profile ID                  |
| Reservations                         | Mews → Peoplevine | Appear as appointments in the Control Panel and on the member portal calendar/itinerary |
| Membership matching                  | Peoplevine → Mews | Links member info to reservations in Mews CRM                                           |

> **Note**: Room bookings are made only in Mews. Peoplevine does not support booking rooms directly. Payments are also handled in Mews (payment sync is on the roadmap).

### Best Practice

* **Run the first sync with a narrow date range** — confirm data appears correctly on both sides before expanding to a wider window.
* **Verify profile matching before bulk sync** — test with one or two members to ensure email/phone matching works as expected.
* **Keep credentials secure** — if you rotate your Mews Access Token, update it immediately in the Peoplevine integration page to avoid sync failures.

### Common Issues

**Reservations not appearing in Peoplevine:** The member profile may not exist in Peoplevine, or the profile identifiers (email, phone) do not match between systems. Verify the member exists in both systems with a matching identifier, then re-run the sync.

**Profile not syncing to Mews:** Check that the Client Token and Access Token are entered correctly and have not expired. Re-enter the credentials and click **CONNECT** again to trigger a fresh connection.

**Duplicate member profiles in Mews:** This happens when a member was created independently in both systems. Use the Connected ID to unify records. See the Connect guide for details on profile deduplication.

### What Happens Next

* Member profiles pushed to Mews are available to front desk and reservations teams
* Hotel reservations from Mews appear as appointments on the member's CRM profile in Peoplevine
* Members can view their hotel stays on the member portal under their calendar and itinerary
* Any profile updates in Peoplevine (address, phone, email) are pushed to Mews automatically

*Last updated: 2026-05-24*


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://help.peoplevine.com/products/integrations-overview/setup-mews.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.