Skip to main content

🐱 Mews

🔗 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

Bookboost on Mews Marketplace

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_enabled must 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

  1. Email updates may fail if the email exists in another profile in Mews

  2. Manual profile edits in Bookboost do not sync back to Mews

  3. 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.

Related Articles
🏨 Online Check-in Form in Bookboost
🛒 Oaky Integration for Upselling
🛒 Oaky Integration for Upselling
How To Personalize Forms in the Digital Reception
🤖 D3X Integration with the Bookboost Unified Inbox
Did this answer your question?