Skip to main content

Portal-MEWS

Portal-MEWS guide and integration

Written by QA

How connect Mews to Portal (Staff Guide)

A concise, step‑by‑step guide for Staff to connect a property’s Mews account to Portal using an access token.

What you need

  • A Portal account with access to the Apps tab.

  • A Mews access token from your verified Mews Marketplace (obtained by your Mews admin/owner).

Important: The only credential required is the access token. There is no Demo Account option for Mews.

  • NOTE: Each PMS account is linked to a single property in the Portal and cannot be shared across multiple properties. For more information, you must contact PMS support.

Quick Start

  1. Get your Mews access token

    Ask your Mews admin to retrieve/generate the token from your verified Mews Marketplace. Copy the token (keep it secure).

  2. Open Portal → Apps

    Sign in to Portal and go to the Apps tab.

  3. Choose Mews

    From the list of apps, select Mews.

  4. Paste token & Save

    Paste your Mews access token into the token field and click Save.

  5. Confirm connection

    After saving, the integration should show Connected once validation succeeds.

Treat the token like a password. Do not share it publicly or commit it to notes or screenshots.
​

Expected Behavior

  • Single credential: Portal validates only the access token—no client ID/secret required.

  • Status updates: After saving a valid token, the integration status changes to Connected. If the token is invalid, an inline error is shown.

  • Propagation time: Changes in token validity may take some time to reflect; status updates are not instantaneous.

Edge Cases & Errors

  • Invalid token at connect time

    You’ll see an error message. Verify you pasted the token correctly (no spaces/line breaks) or ask your Mews admin for a new token.

  • Token later revoked in Mews

    If the token is revoked from the Mews dashboard, Portal will eventually change the integration status to Broken. This may take time to appear.

    Fix: Obtain a new access token from the verified Mews Marketplace, return to Portal → Apps → Mews, paste the new token, and Save.

Troubleshooting

I saved a token but it still isn’t Connected.

  • Refresh the page after a short wait.

  • Confirm you used the correct property’s Mews token.

  • Ensure there are no extra characters (leading/trailing spaces) in the token field.

  • Ask your Mews admin to confirm the token is active and not expired/revoked.

The status says Broken. What do I do?

  • The current token is invalid or revoked in Mews. Retrieve a new token and update it in Portal.

Can I use a demo or sandbox like Goki?

  • No. Mews does not support a “Demo Account” toggle in this integration.

Security Best Practices

  • Store tokens only in Portal; avoid sharing via email or chat.

  • Rotate tokens when staff with token access change roles.

  • Limit who can access the Apps tab in Portal to trusted admins.

FAQs

Q: Do I need anything besides the access token?

A: No. Only the Mews access token is required.

Q: How long do status changes take to appear?

A: Status updates (especially after a token is revoked) may take some time to show in Portal.

Q: Will existing data sync immediately after connecting?

A: Initial validation is quick, but downstream syncs may take time based on background processing.

Q: Why does the reservation not appear in the Portal?
A: No device installed in the room — If no device is assigned when the reservation is created in Mews, it won’t transfer to Portal until a device is installed in the main room.

  • Room not mapped to a Portal space — If the room isn’t mapped, no keychain will be generated. Adding the mapping should trigger it.

  • Mews/any PMS integration disruption — If the integration is temporarily broken, reservations won’t sync.

Important: In most cases, the PMS is responsible for sending data to the Portal. If a reservation is missing, please get in touch with PMS support to investigate why it wasn’t sent.

Quick fix: Often, updating the reservation (e.g., unassigning and reassigning the room) helps push it to Portal.

Q: Can a door code be sent to MEWS?

A: Integrations like Portal can send PIN codes to Mews, and Mews stores them. However, Mews does not display these PINs anywhere:

  • Not in reservations or guest profiles

  • Not in the Guest Portal

  • Not in emails (no merge tag)

  • On Mews side: there’s a planned feature to show PINs in the Guest Portal and emails, but it’s not available yet. Please get in touch with MEWS support.

Did this answer your question?