Skip to main content

Full Revenue Push | Toast to Mews

By Omniboost

Updated yesterday

Guide Overview:

This guide provides detailed instructions on setting up and configuring your integration between Toast and Mews via Datahub. It includes the following sections:

  • Integration Setup Requirements

  • Accessing Datahub

  • Setting Up Two-Factor Authentication (2FA)

  • Starting the Integration Setup

  • Establishing a connection with Toast and Mews

  • Configuring POS Settings

  • Configuring PMS Settings

  • Configuring the mapping​

  • Testing the integration

Video Walkthrough
For a general step-by-step explanation of the onboarding process, you can watch our video guide here: Connecting Toast to your PMS

Integration Setup Requirements

Before you can begin setting up the integration, please ensure the following steps are completed.

Toast integration Request:

To start the setup process, you must first request the “Toast to Mews by Omniboost” integration via the Toast Marketplace.

This step is required for two reasons:

  • It allows Omniboost to receive the necessary credentials and information from Toast

  • It automatically triggers the onboarding process on the Omniboost side

If you have not done so already, you can find more information on how to submit the request in the Toast Marketplace here: How to request the Toast integration in the Toast Marketplace?

Mews integration Request:

In addition to the Toast integration request, you must also request the “Toast to Mews by Omniboost” integration through the Mews Marketplace.

This step is essential because:

  • It generates the required access token

  • This token will later be used to connect your Toast environment to your Mews environment

If you have not done so already, you can find more information on how to submit the request in the Mews Marketplace here: How to request the Toast integration in the Mews marketplace?

Services and Outlets within Mews:

Depending on the level of detail you want in your reports within Mews, you can choose between two setup options.

Option 1 - More Detailed Reporting

  • Create a Service in Mews for each Toast revenue center, with the same names as your Toast revenue centers

  • Create an Outlet in Mews for each Toast revenue center, with the same names as your Toast revenue centers

Option 2 - Simplified Reporting

  • Create a single Service named: e.g. "Toast"

  • Create a single Outlet named: e.g. "Toast"

Standard Accounting Categories:

To map revenue from Toast POS to Mews, you must create accounting categories in Mews. Depending on the level of detail you want in your financial reporting, you can choose one of the following setup options:

Option 1 - Maximum Detail

Create accounting categories based on:

  • Revenue Center

  • Meal Period (e.g., breakfast, lunch, dinner)

  • Sales Category (e.g., food, beverage, alcohol)

E.g. "Restaurant Food Breakfast"

Option 2 – Detailed

Create accounting categories based on:

  • Revenue Center

  • Sales Category

E.g. "Restaurant Food"

Option 3 – Limited Detail

Create accounting categories based on:

  • Revenue Center or Sales Category

E.g. "Food" or "Restaurant"

Option 4 – Simplified

Create:

  • One unified accounting category for all Toast revenue

E.g. "Toast"

Use this link to learn how to create a accounting category: Configure Accounting Category

Additional accounting Categories within Mews:

In addition to your standard accounting categories in Mews, you must create several additional categories to properly handle fallback postings and non-revenue transactions from Toast POS.

These categories ensure that all transactions are correctly recorded, even in cases where standard mappings are missing, instead of turning to errors.

  • An accounting category called 'Fallback Toast'

  • An accounting category called 'Fallback Payments Toast'

  • An accounting category called 'Service Charge Toast'

  • An accounting category called 'Gratuity Toast'

Use this link to learn how to create a accounting category: Configure Accounting Category

Adjustment Accounting Categories:

For all of the above accounting category in Mews, you must create a corresponding adjustment category.

E.g. "Restaurant Food" and "Restaurant Food Adjustment".

Adjustment accounting categories are used for reconciliation purposes when a receipt in Toast POS is modified after it has already been closed and posted to Mews.

Use this link to learn how to create a accounting category: Configure Accounting Category

Accessing DataHub

To access DataHub, follow these steps:

  1. Obtain Login Credentials:

    • After requesting the integration in the Toast Marketplace you will receive your person login credentials via email. If you haven't received them, kindly request them from your designated contact at Omniboost or send an email to 'pos-support@omniboost.com'

  2. Navigate to DataHub:

  3. Enter Your Credentials:

    • Use the email and password provided Omniboost

  4. Select “Remember Me”:

    • Check the Remember me box to save your login details for future access.

  5. Click “Login”:

    • Press the Login button to proceed.

Setting Up Two-Factor Authentication (2FA)

When logging into Omniboost DataHub for the first time, you will be prompted to set up Two-Factor Authentication (2FA).

This step is required and must be completed carefully, as you will need your 2FA device each time you log in going forward.

  1. Download a 2FA Application

    • Install a 2FA application on your smartphone, such as:

      • Google Authenticator [LINK]

      • Microsoft Authenticator [LINK]

  2. Scan the QR Code

    • Open your 2FA app

    • Select the option to add a new account

    • Scan the QR code displayed on the DataHub screen

    This will link your account and start generating authentication codes.

  3. Generate and Enter 2FA Code

    • Your 2FA app will generate a new code every 30 seconds

    • Enter the current code into the DataHub screen to verify your setup

  4. Save Recovery Codes

    • Carefully store the recovery codes shown on the screen

    • These codes allow you to regain access if you lose your phone or 2FA app

Important

You will need your 2FA app every time you log in to DataHub.

Starting the Integration Setup

  1. Access the Next Screen:

    • After successfully creating your user and setting up Two-Factor Authentication (2FA), you will be directed to the next screen.

  2. Click “Start Setup”:

    • On this screen, click the Connect button to begin configuring the integration.

Establishing a connection with Toast and Mews

To connect your Toast POS environment to Mews, you will need to enter your Mews Access Token in DataHub.

1. Locate Your Mews Access Token

Follow these steps in Mews:

  • Go to Marketplace

  • Navigate to My Subscriptions

  • Select Toast POS

  • Click Edit

  • In the top-right corner, click the key icon 🔑

This will reveal your Access Token.

Important:

If you do not see the Toast POS integration listed under My Subscriptions, you must first request the “Toast to Mews by Omniboost” integration in the Mews Marketplace.

The Access Token will only be available after this request has been submitted.

You can find more information on how to submit the request in the Mews Marketplace here: How to request the Toast integration in the Mews marketplace?

2. Enter the Access Token in DataHub

  • Copy the Access Token from Mews

  • Paste it into the designated field in Omniboost DataHub

3. Test the Connection

  • Press Test Connection to test the connection

4. Save the Connection

  • If the Connection test was successful, please press Next Step to save the connection and start with the configuration

Configuring Pos Settings

Configuring the 'On Room Payment Type'

  • Select the payment type that represents room charges (typically named Room Charge)

  • This ensures that these transactions are recognized and sent to Mews as revenue only (not as payments)

If you do not see the Room Charge option in the drop down menu, please do send an email to 'pos-support@omniboost.com'.

Fill in the 'Tip Name'

Define the description used for tip-related accounting categories in Mews.

  • Enter a name such as:

    • Toast Tip

    • Gratuity

This name will be used as a description for the corresponding accounting category.

Enable or disable 'Use Meal Periods'

Choose whether you want to include meal periods (e.g., breakfast, lunch, dinner) in your revenue mapping.

Please refer to the section “Standard Accounting Categories” above:

If you selected Option 1 - Maximum Detail, meal periods must be enabled and configured.

If you chose a less detailed setup (Options 2–4), enabling meal periods has no added value and should be left disabled.

When enabled:

  • You can map revenue in more detail, allowing for more detailed reporting in Mews

  • Example:

    • "Restaurant food breakfast"

    • "Restaurant food lunch"

    • "Restaurant beverage breakfast"

    • "Restaurant beverage lunch"

When disabled:

  • Mapping will be simpler and less work

  • Example:

    • "Restaurant food"

    • "Restaurant beverage"

Tip:

Only enable meal periods if you plan to map all additional fields and mapping pages required for this higher level of reporting.

It increases setup complexity but allows for more granular insights in Mews.

Configure the 'Set Meal Periods' (only if 'Use Meal Periods' is enabled)

If you have enabled “Use Meal Periods”, you must define your meal periods. Transactions will be assigned to a meal period based on the opening time of the receipt in Toast, and will be mapped accordingly in Mews.

In order to do so please complete the next steps:

  • Select a meal period from the dropdown menu

  • Enter a name for the meal period (e.g., Breakfast, Lunch, Dinner)

  • Set the start time and end time

    • Meal periods must cover the full 24 hours of the day

    • There may be no gaps or overlaps between meal periods

    • Each meal period must start immediately when the previous one ends

Repeat these steps for each meal period you want to configure.

Important:

Incorrect configuration will result in mapping issues.

Configuring Pms Settings

Default and Adjustment Codes

These settings define where transactions are posted when no specific mapping is applied; for example, when a new sales category is added in Toast but not yet mapped in Omniboost DataHub, or when a new sales item is created in Toast that is not linked to an existing sales category.

  • Default Analysis Code → Select: Fallback Toast

    • Used for revenue items without a mapping

  • Adjustment Default Analysis Code → Select: Fallback Toast Adjustment

    • Used for adjusted revenue items without a mapping (when a receipt in Toast is modified after it was already closed)

  • Default Payment Code → Select: Fallback Toast

    • Used for payments without a mapping

  • Adjustment Default Payment Code → Select: Fallback Toast Adjustment

    • Used for adjusted payments without a mapping (when a receipt in Toast is modified after it was already closed)

Note:

These fallback categories act as a safety net.

If mappings are missing or incorrect, transactions will be posted here.

Select Outlets and Services

You must map each Toast revenue center to the correct Outlet and Service in Mews.

For each revenue center (e.g., Dining Room, Bar, Patio):

  • Select the corresponding Outlet from Mews → this is where revenue will be posted

  • Select the corresponding Service from Mews → this is where payments will be recorded

Tip and Service Charge Configuration

Configure how tips and service charges are posted in Mews:

  • Tip Code → Gratuity Toast

  • Adjustment Tip Code → Gratuity Toast Adjustment

  • Service Charge Code → Service Charge Toast

  • Adjustment Service Charge Code → Service Charge Toast Adjustment

  • Service Charge With VAT Code → Service Charge Toast

  • Adjustment Service Charge With VAT Code → Service Charge Toast Adjustment

Tax Codes

Map your Toast tax rates to the correct tax codes in Mews.

  • For each Toast tax rate, select the corresponding Mews tax code(s)

  • If a Toast tax rate includes multiple Mews tax codes, you must select all relevant Mews tax codes so that the total matches

Examples:

  • 0% → Map to the appropriate 0% tax code (e.g., US-NE-Z (0%))

  • 8.375% → Select all Mews tax codes that together add up to 8.375%

Important:

  • Tax mappings must match your local tax configuration in Mews

  • Incorrect tax mapping will lead to errors

Once all fields are completed:

  • Click Next Step to continue

Configuring the mapping

In this step, you will map all sales categories, service charges, and payment methods from Toast to Mews within Omniboost DataHub.

Navigation Tabs

At the top of the screen, you will see different tabs (e.g., Pool, Bar, Patio, Dining Room, Adjustment, etc.).

  • Each tab represents a (Toast) revenue center, meal period, or adjustment type

  • The first page acts as the default mapping for all tabs that are not configured

  • The “Adjustment” tab acts as the default for all adjustment-related tabs

  • Mapping additional tabs is not mandatory, however, configuring them allows for more detailed and accurate reporting in Mews

  • Any additional tab you configure will override the default mapping for that specific revenue center, meal period, or adjustment type

Categories

Map each Sales Category from Toast POS to the correct Accounting Category in Mews.

For each Sales Category (e.g., Beer, Food, Liquor, Wine):

  • Select the corresponding Mews accounting category

You can configure this in four different ways, depending on the level of detail you want in your Mews reports:

Option 1 - Maximum Detail

Map accounting categories based on:

  • Revenue Center

  • Meal Period (e.g., breakfast, lunch, dinner)

  • Sales Category (e.g., food, beverage, alcohol)

E.g. "Restaurant Food Breakfast"

When using meal periods, you do not need to map the revenue center pages without a meal period assigned.

All transactions are assigned to a meal period based on the receipt opening time, so the default revenue center pages without a meal period will not be used.

Option 2 – Detailed

Map accounting categories based on:

  • Revenue Center

  • Sales Category

E.g. "Restaurant Food"

Option 3 – Limited Detail

Map accounting categories based on:

  • Revenue Center or Sales Category

E.g. "Food" or "Restaurant"

Option 4 – Simplified

Map:

  • One unified accounting category for all Toast revenue

    • You can select a PMS category at the top Select PMS Category to apply to all and click Apply to assign it to all

E.g. "Toast"

Helpful Links:

Learn how to create an accounting category in Mews: Configure Accounting Category

Learn how to create Sales Categories in Toast: Configure Sales Categories

Both accounting categories and sales categories are fetched in real time.

After creating new ones, simply refresh the page and they will appear in the dropdown options.

Service Charges

Map all POS service charges to the correct Mews service charge accounting categories.

Examples:

  • Delivery Fee

  • Gratuity 10% / 18% / 20%

For each:

  • Select the corresponding Mews service charge accounting category

Payment Methods

Map each POS payment method to the correct Mews payment type.

Examples:

  • Amex, Visa, MasterCard

  • Cash

  • Room Charge

  • House Account

For each:

  • Select the corresponding Mews payment type

Final Step:

Click Save Mapping at the bottom of the screen. Make sure all required fields are completed, otherwise the page will not save.

After clicking Save Mapping & Continue, the integration setup is complete.

Important: Full Revenue Push (direct payments) is not enabled automatically: you must email 📧 pos-support@omniboost.com to request activation.

The integration is now ready for Room Charge transactions, and you can run a test using the Room Charge payment method in Toast (see testing section below).

Once Full Revenue Push is activated by our team, all direct payments will be synced to Mews every 15 minutes.

Important: If you have multiple locations in Toast (e.g., Market, Rooftop), you must configure the integration for each location separately by following the same steps.

You can switch between locations using the dropdown menu in the top-left corner of Omniboost DataHub.

Testing the Integration

You can now test the integration using a Toast POS handheld or terminal with a checked-in room in Mews.

How to run a test:

  • Create a new receipt on a Toast handheld or terminal

  • Select the payment method Room Charge

    • Note: this may be located under “More payment options”

  • Search for and select the correct room number

  • Close the receipt

Verify in Mews:

  • Check that the transaction appears correctly in Mews

  • Confirm that the revenue is posted to the correct Service

Test Adjustment (Recommended)

  • Void the receipt in Toast

  • Verify that the transaction is also voided or adjusted correctly in Mews

All transactions and potential errors can be reviewed in the logs within Omniboost DataHub, accessible from the left-hand menu.

Important:

If you need to modify a receipt in Toast after the room charge has already been sent to Mews, you must void the entire receipt, make the necessary changes, and create a new room charge.

Updating an existing receipt will not be reflected correctly in Mews.

If you encounter any issues, contact pos-support@omniboost.io for assistance.

Did this answer your question?