🐱 Mews
Mews Property Management System
🔗 Mews Integration Guide
Introduction
This guide provides instructions for setting up and managing the Bookboost integration with Mews PMS (Property Management System). The integration allows properties using Mews to synchronise guest and reservation data with Bookboost, enabling automated communication, CRM campaigns, and guest profile management across channels.
Connection Manual
Step 1: Obtain API Credentials
Before connecting to Bookboost, you'll need to obtain the necessary API credentials from your Mews account:
- Click on the top left Burger menu
- Go to Marketplace → click on Discover Marketplace
- Search for Bookboost → click on Add to Mews
Step 2: Bookboost Configuration
Once the “Connect” button is triggered, the Bookboost onboarding team will receive an email with the credentials required to activate the connection.
Step 3: Bookboost Historical Import (Optional)
If you have past reservations stored in Mews, Bookboost can import these using a historical sync. The default sync range includes ~2 years in the past and ~1 year in the future. Custom date ranges can be requested.
Best Practices
General
To improve personalisation, ensure that Mews guest profiles are complete. Mews remains the source of truth; Bookboost pulls guest and reservation data from it.
Note: Some data can be updated from Bookboost back to Mews using forms. See “Two-Way Integration” for details.
Communication Workflow
- Status-based messaging: Trigger messages in Bookboost based on Mews reservation status changes.
- Avoid duplicate communication: Turn off Mews’ automated messages if Bookboost manages guest messaging. Disable Mews messages here
Online Check-in Integration
Please see this video for a demonstration of the Mews Online Check in Feature
Token: {{mews.checkin_link_primary_guest}}
Use this token in campaigns to send a personalised check-in link for each guest.
How it works:
- Guests access the Mews online check-in page
- They can fill personal details, add upsells, and complete the process
Requirements:
- Mews integration must be active
- Online check-in must be enabled in Mews
mews_guest_portal_links_enabledmust be active (set by Bookboost)
Activation:
- Contact the Bookboost product integrations team to enable the integration
- Once enabled, links generate automatically for each reservation (allow 5–10 min delay)
Attention (2025): Online Check-in and Online Check-Out are different features. Currently Mews DOES NOT offer the same functionality for the Online Check-out. Moreover, it’s not possible to disable automatic communication going out from Mews related to the Online Check-out unless you disable the entire Online-Check-out Feature.
Available Tokens
🏨 Reservation Details
reservation.booking_reference
reservation.channel_category
reservation.market_category
reservation.number_of_adults
reservation.nights
reservation.balance
reservation.currency
reservation.total_gross_amount
reservation.subtotal
reservation.number_of_children
reservation.total_tax
reservation.start
reservation.end
reservation.arrival_date_time
reservation.departure_date_time
reservation.status
reservation.product_list
reservation.uuid
reservation.created_at_in_pms
reservation.booker_requests
reservation.channel_segment
👤 Guest Information
user.full_name
user.salutation
user.first_name
user.last_name
user.email
user.phone
mews.checkin_link_primary_guest
🧳 Reservation Set (Group Booking)
reservation_set.reference
reservation_set.start
reservation_set.end
reservation_set.number_of_rooms
💰 Rate Plan Information
rate_plan.name
rate_plan.code
🌐 Channel Manager Information
channel_manager.channel_manager_name
channel_manager.channel_manager_number
channel_manager.channel_manager_group_number
channel_manager.channel_number
🛏️ Room Information
space.name
space.number
space.floor
room.access_token
🛏️ Room Type Information
space_type.name
space_type.code
space_type.description
🧾 Additional Identifiers
connector.connector_reservation_id
reservation_set_connector.connector_reservation_set_id
company.name
reservation_gates.access_tokens
user_integration_mews.connector_user_id
Two-Way Integration Features
Data Flow from Mews to Bookboost
- Guest and reservation data sync every 5 minutes
- 50+ tokens available for campaigns
- Includes booking details, guest profiles, reservation notes
Data Flow from Bookboost to Mews (via Forms)
Only updates submitted through forms are pushed to Mews. These include:
- Personal Information
- First name
- Last name (required)
- Title (required)
- Salutation
- Gender
- Primary email
- Phone number
- Nationality
- Birthday
- Identity Documents
- Document type (required if document submitted)
- Identification number (required if document submitted)
- Issue date
- Expiry date
- Address
- Address line 1 (required if address submitted)
- Address line 2
- City (required if address submitted)
- Zip code
- Country (required if address submitted)
Known Limitations
- Email updates may fail if the email exists in another profile in Mews
- Manual profile edits in Bookboost do not sync back to Mews
- Notes flow one way (Mews → Bookboost only)
Noteworthy Information About Mews
Technical Considerations
- Multi-property support: Each Mews property requires a separate integration and app in Bookboost
- API rate limits: Enforced by Mews. Bookboost handles this internally but syncing delays may occur
- Webhook reliability: Mews webhooks can be delayed. Bookboost uses polling for consistency
Data Structure Specifics
- Company bookings: Mews distinguishes between company and individual bookings. You can set up journeys that treat bookers and guests differently using reservation set tokens.
- Space categories: These replace traditional room types in Mews.
- Products vs. services: Charges are grouped accordingly and appear in message tokens.
- Guest segmentation: Mews has limited options. Bookboost allows flexible, tag-based segmentation. Read more here
Operational Best Practices
- Reservation notes: Add helpful guest info in Mews notes. These are imported by Bookboost but not written back.
- Front desk awareness: Staff should know that while Bookboost can handle communication, Mews must be used for modifying bookings.
Need Help?
Please contact us through the ‘Talk to Us’ on the left Menu in the platform or through the Bookboost Support email at support@bookboost.io if you have questions or need additional support.