Skip to main content

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​

SettingWhat it controlsWhen you use it
Access TokenConnects AVA to MewsAlways
Advanced → Client TokenAdvanced connection credentialOnly if support asks
Advanced → Client IDYour property identifier in MewsOnly if support asks
Advanced → Demo ModeUses sandbox endpoints for testingOnly for test environments

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

    Mews Marketplace Search

  3. Click My Subscriptions

    Mews Subscriptions

  4. Find Vouch AVA Front Desk Agent

  5. Click Edit

  6. Open the Access Token section

  7. Copy the Token ID

    Mews Access Token

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

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.

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

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