Skip to main content

Available Mews tokens for campaigns

The Mews data tokens you can use to personalise campaigns and messages.

Introduction

Tokens let you drop live Mews data into any campaign or message, so each guest sees their own reservation details, name, and room information. This article lists the Mews tokens available in Bookboost, grouped by category.

How tokens work

Add a token where you want the live value to appear, for example {{user.first_name}} in a greeting. When the message sends, Bookboost replaces the token with that guest's data from Mews. More than 50 tokens are available.

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

  • reservation.guarantee_type

For Mews properties, reservation.guarantee_type is set to credit_card when a credit card is attached to the reservation, and is empty otherwise. See Guarantee type for Mews reservations for how it is derived and what it does not cover.

Guest information

  • user.full_name

  • user.salutation

  • user.first_name

  • user.last_name

  • user.email

  • user.phone

The user. tokens above always resolve to the recipient of the message. When the booker is the recipient but you need to name the guest who is staying, use the primary guest tokens below.

Primary guest

The primary guest is the main guest on the reservation, who is not always the person receiving the message. These tokens reference that guest's details regardless of who the message is sent to, which helps when retreat organisers, corporate travel coordinators, or group booking managers book on behalf of others.

  • primary_guest.full_name

  • primary_guest.salutation

  • primary_guest.first_name

  • primary_guest.last_name

  • primary_guest.email

  • primary_guest.phone

  • primary_guest.raw_phone — the phone number without formatting

For example, {{primary_guest.full_name}} is confirmed for your upcoming stay names the assigned guest even when the confirmation goes to the person who made the booking.

Mews links and QR codes

These tokens resolve to a guest-specific Mews link or QR code rather than a plain text value.

  • mews.checkin_link_primary_guest — the primary guest's Mews online check-in link

  • mews.homepage_link_primary_guest — the primary guest's Mews Navigator homepage link

  • mews.self_checkin_qr_code_data — the data used to generate a self-check-in QR code

To place one of these inside a WhatsApp Link button, see Using a Mews Token in a Link Button URL.

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

  • rate_plan_group.name

  • rate_plan_group.code

  • rate_plan_group.description

A rate plan is the specific rate a reservation was booked on. A rate group is the group that rate belongs to in Mews, and it carries the guest-friendly name and description your property maintains there, for example a "Flexible Rate" label and its cancellation wording. The rate_plan_group tokens resolve to empty if the reservation's rate does not belong to a rate group in Mews.

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

Configuration and Setup

No setup is required to use these tokens once the Mews integration is active. The exception is the online check-in link token mews.checkin_link_primary_guest, which the Bookboost product integrations team enables for you. See What the Mews integration does for how online check-in works.

Support

Please contact us through the 'Talk to Us' option 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
Did this answer your question?