Set Up Mews PMS Integration

Quick Setup

Most hotels only need the Access Token. This takes about 10 minutes.

This guide helps you connect AVA to Mews so reservations and guest details sync correctly.

Where to Find It

Settings → Essentials → Property Management System (PMS) Integration

Quick Reference

Setting	What it controls	When you use it
Access Token	Connects AVA to Mews	Always
Advanced → Client Token	Advanced connection credential	Only if support asks
Advanced → Client ID	Your property identifier in Mews	Only if support asks
Advanced → Demo Mode	Uses sandbox endpoints for testing	Only for test environments
Reservation comments	Pulls Mews service order notes into AVA	When AVA reads a reservation
Room payment waiver	Uses the returned invoice to decide waivers	When the invoice marks room payment as waived
Payment waiver keywords	Shows the waiver keyword field in AVA payment settings	Only when your Mews connection exposes keyword-waiver support

Before You Start

You'll need:

• Access to the Mews admin area
• The Access Token / Token ID for the AVA integration
• Admin permission to update PMS settings in AVA

info

If you don't have the Access Token, contact your Mews admin or AVA support.

How to Get Your Mews Access Token

Follow these steps in Mews:

1. Log in to Mews PMS

2. Click Marketplace in the sidebar

   

3. Click My Subscriptions

   

4. Find Vouch AVA Front Desk Agent

5. Click Edit

6. Open the Access Token section

7. Copy the Token ID

   

tip

Paste the token into AVA right away so you don't lose it.

Configuration Steps

Step 1: Select Mews

1. Go to Settings → Essentials → PMS Integration
2. Click the Mews card
3. The Mews configuration form appears

Step 2: Enter Access Token

1. Paste the Token ID from Mews into the Access Token field
2. The token is hidden after save for security

Masked values are safe

If you return later and see masked characters, leave them as-is and click Save. AVA keeps the saved Access Token, Client Token, and Client ID.

If you need Advanced Mews settings (support only)

1. Click Advanced
2. Enter the values support provided:
   • Client Token
   • Client ID
3. Optional: Turn on Demo Mode if you are testing with sandbox endpoints

warning

Do not change Advanced values unless support tells you to. Wrong values can stop syncing.

Step 3: Save

1. Click Save at the bottom of the page
2. Look for the success message
3. The Access Token field shows a placeholder to protect the secret

What Happens After Connection

• ✅ AVA starts using Mews data for reservations and guest details
• ✅ The Access Token field shows masked characters
• ✅ Use Edit Token if you need to update the token later
• ℹ️ AVA keeps the current Demo Mode value when you save other Mews fields.
• ℹ️ Production does not force Demo Mode to OFF.
• ✅ Mews company names now fill reservation source labels when AVA can resolve them.
• ✅ Mews reservations are treated as hotel collect in AVA.
• ✅ Do Not Move room-lock status stays in sync with Mews.
• ✅ AVA skips blocked Mews rooms during automatic assignment and retries another clean room when possible.
• ✅ AVA pulls Mews service order notes into reservation comments.
• ✅ Matching notes can waive room payment when the invoice returns a waiver flag.
• ✅ AVA loads full invoice details before checking the waiver on single-reservation reads.
• ✅ AVA keeps unassigned Mews rooms visible in multi-room bookings.

Guest & Staff Impact

• Guest forms adapt to Mews rules. Required fields and hidden fields change based on Mews configuration, so guests only see what is needed.
• Reservation lookup uses Mews. If Mews is not configured, the guest lookup step will fail.
• Booking source labels can show Mews company names. If AVA can resolve a company name, it uses that name instead of a raw company ID.
• Mews source collect now defaults to hotel collect. That keeps source labels aligned with the reservation contract AVA receives.
• Locked rooms stay locked in AVA. If Mews marks a reservation as locked, Streamliner shows the lock icon in room-change views.
• Service order notes become reservation comments. Staff can review note text during reservation lookup.
• Waived room payments stay explainable. When Mews marks the invoice as waived, AVA shows the note text as the waiver reason.
• Payment waiver keywords are capability-based. If Mews exposes them, AVA shows the waiver keyword field in payment settings.

Multi-Room Bookings Stay Complete

AVA keeps every booked Mews room visible, even before Mews assigns a physical room. The main room stays first in the list. This helps staff see the full booking during lookup and check-in.

Shared Booking Emails Create Separate Guests

If two guests share the same booking email, AVA creates a separate Mews customer. AVA only reuses a customer when the document number matches an existing record. If AVA already has a direct Mews guest reference, it keeps updating that guest.

Exact matches

AVA matches the waiver keyword as a whole word. PAID does not match UNPAID.

Troubleshooting

"Access Token is required" Error

What you see: "Access Token is required"

Fix:

1. Paste the Token ID from Mews
2. Click Save again
3. ✓ The error disappears once saved

Token Saved But No Data Syncing

What you see: You saved the token, but reservations do not appear

Fix:

1. Wait 10-15 minutes for the first sync
2. Refresh the page and confirm Mews is still selected
3. Ask your Mews admin to confirm the AVA subscription is active
4. Contact AVA support if the issue continues

Masked fields return after reload

What you see: The Access Token or advanced fields show masked characters after you reload the page.

Fix:

1. Leave the masked values in place.
2. Click Save again.
3. ✓ AVA keeps the saved Mews credentials.

You cannot find Client Token, Client ID, or Demo Mode

What you see: You do not see Client Token, Client ID, or Demo Mode fields

Fix:

1. Click Advanced
2. ✓ The advanced fields appear inside the Advanced section

Demo Mode is on, but syncing looks wrong

What you see: Missing reservations or unexpected test data

Fix:

1. Turn off Demo Mode
2. Click Save
3. Refresh the page and check your connection status
4. Contact support if the issue continues

Demo Mode does not match after saving

What you see: The Demo Mode checkbox changes after refresh, or does not match the saved Mews setting.

Fix:

1. Open Advanced.
2. Check the Demo Mode value.
3. Save only the change you want.
4. Refresh the page.
5. Contact support if the checkbox still disagrees with the saved Mews config.

A room does not appear in room changes

What you see: The room is missing from Allow move room.

Fix:

1. Check the reservation in Mews.
2. Remove the room lock if the room should be movable.
3. Refresh the reservation in AVA.
4. Try the room change again.

Mews blocked room assignment

What you see: Check-in or room change shows "space is blocked" or "room unavailable".

Fix:

1. Wait for AVA to try another clean room.
2. Assign a different room in Mews if no clean room is available.
3. Refresh AVA and try again.

Room payment is still payable

What you see: A Mews reservation still asks for room payment.

Fix:

1. Open the reservation in Mews.
2. Check the service order notes.
3. Confirm the note uses the exact waiver wording.
4. Refresh the reservation in AVA.
5. Contact support if the payment still appears.

Waiver reason looks wrong

What you see: AVA waives the room payment, but the reason text is unexpected.

Fix:

1. Check the Mews service order note that matched.
2. Confirm the note text is the one you expect.
3. Remember that AVA matches whole words only.
4. Contact support if the waiver reason still looks wrong.

Verification Checklist

• Mews is selected in Select PMS Provider
• Access Token is entered and saved without errors
• The Access Token field shows masked characters after refresh
• Reservations begin syncing from Mews

Still Stuck?

Contact success@vouch-technologies.com if:

• ❌ Syncing does not start after 15 minutes
• ❌ You see a save error you cannot resolve
• ❌ You need Advanced settings and do not have values

Helpful to include:

• Screenshot of the PMS Integration section
• Your PMS provider (Mews)
• The exact error text, if any

Related Guides

• PMS Connection
• Manage Reservation Payments
• PMS Connection Errors