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.
Quick Start
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).
Open Portal → Apps
Sign in to Portal and go to the Apps tab.
Choose Mews
From the list of apps, select Mews.
Paste token & Save
Paste your Mews access token into the token field and click Save.
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.