Setting up a PAR Brink Integration in the GRUBBRR Portal

Last updated: August 5, 2026

Location-Level Configuration

With access to the client's API credentials, we can begin the integration process. After creating a new location for your client, you'll need to complete the following three steps:

Connect GRUBBRR to the client's POS
Map Tenders
Map Order Types

Connecting GRUBBRR to the Client's POS

From your client's new location dashboard, complete the following:

Select Integration from the left sidebar menu
Select PAR Brink POS from the dropdown menu
In the AccessToken field, enter VTusm6es0UKkuMudaxArtg==
- Note: Make sure there are no spaces after the text
Enter the Location Token obtained from PAR Brink
- Note: Make sure there are no spaces after the text
Enter the Base URL obtained from PAR Brink
- Note: Make sure the URL ends with a backslash (/)
Select the Menu to pull
- If the client has configured a GRUBBRR-Specific menu, as mentioned above, then make sure you select that menu for the initial pull.
- If the client has not configured a menu for GRUBBRR, you will need to select Entire Catalog.
Enable Daily Sync, and select the Sync Pricing Only option.
- Set the Daily Sync Time according to Client Preferences
Enable Suppress Confirmation Email
(Optional): The Order Prefix field allows the kiosk to add an identifying prefix (such as "K-" for Kiosk orders) to the orders it sends to the client's POS.
Item Availability Check Times should be reviewed with the client and configured according to their preferences
- We should always use this feature, to ensure that the client's Kiosk menu accurately reflects what's available on their POS
(Optional): Default Upsell Open Discount allows us to apply discounted upsells to items in the PAR Brink POS, if the client wants to offer them. Options should populate after an initial Menu Sync.
(Optional): Donation Open Item allows us to create and apply charity donations to orders made at the kiosk if the client wants to offer them. Options should populate after an initial Menu Sync.
Ensure that the following flags are all enabled:
- Ignore Par Brink Display Order Settings
- Ignore Category Item Mapping
- Ignore Combo Item Mapping
- Ignore Common Modifier Item Mapping
- Ignore Common Modifier Group Settings
Ensure that Show New Records on Devices is turned off.
Select Save Only at the bottom of the screen.

Map Tenders

After the initial menu pull, map the Client POS’s tender types to the GRUBBRR payment types. This will be done according to the client’s preferences.

To complete tender mapping:

Log in to the GRUBBRR Portal at the location level
Select Integration from the left sidebar menu
Select PAR Brink POS from the dropdown menu
Enter a Default Tender ID
- This is the fallback tender type that will be used if the individual tender type has not been mapped
- If a tender type has been mapped, it will not become the default
Map the remaining applicable tender types by selecting an option from the tender dropdown
Select Save & Sync Menu

Map Order Types

It's important to map kiosk order types to the appropriate ones in the client's PAR Brink POS. Like tender mapping, order type mapping will associate the POS's order types with existing GRUBBRR order types. If we don't do this, it can cause orders to fail. To map order types, follow the steps below:

To complete order type mapping:

Log in to the GRUBBRR Portal at the location level
Select Configure from the left sidebar menu
Select General Settings from the dropdown menu
Locate the Order Type table under the Common tab
Select a Third Party Order Type from the dropdown for all applicable order types
Scroll to the bottom of the page and select Save

Note: We can not pull Order Numbers from the PAR POS, so please ensure that Clients are using Ask Customer Name or Kiosk Table Tent as part of their order flow.

Managing the Menu

After completing our initial menu pull, we'll need to configure the menu for use on the client's GRUBBRR kiosks. This article will outline the following processes, though we'll note that those processes can vary slightly between clients who have created kiosk-ready menus in PAR and those who haven't.

Best Practice Notes
Category Configuration
Item Configuration
Ingredient Configuration
Common Modifier Configuration
Custom Combo Configuration

Note: While we can create new combos, categories, and modifier groups, we can not create new items, ingredients, or selections in the GRUBBRR Portal.

Best Practice: Cloning Menu Entries

In some sections below, we recommend cloning specific menu entries for clients where we pull the Entire Catalog from PAR. Cloning allows us to duplicate menu entries from PAR Brink and then configure the duplicates in GRUBBRR's Portal while preserving external reference IDs from the PAR Brink system.

We recommend this for two key reasons. First, it allows us to ensure that everything configured in the GRUBBRR Portal has a valid external reference ID in the PAR Brink system, minimizing the chance of order errors. Second, configuring the duplicated items in the GRUBBRR Portal ensures that our configurations aren't overwritten when a client syncs GRUBBRR with the PAR Portal.

Category Configuration

First, we want to ensure that all categories imported from PAR Brink have been disabled in the GRUBBRR Portal. We create and manage our categories to minimize the potential for interference between our system and the client's POS.

Details about manually enabling and disabling categories can be found in GRUBBRR's Categories article; however, you can disable categories in bulk by following the steps below.

Select Menu from the left sidebar
Select Catalog Management from the dropdown
Select Categories
Click on the Bulk Edit button at the top of the table
Click the checkbox at the top left of the Category Bulk Edit page to select all displayed categories
In the Actions Dropdown, select Disable Category
Click on Update to apply your changes.

After disabling the categories pulled from PAR Brink, Create new categories according to the client's instructions or the provided menu sample.

Item Configuration

Because we left the Show New Records on Devices unchecked during the initial menu sync, no menu items will be configured to display on the client's kiosk. So, your next step is to go through and enable the items for display on the GRUBBRR Kiosk.

Remember: Do not add new items or change pricing through the GRUBBRR Portal. This can cause errors when customers submit orders through the kiosk.

To Edit an Item's display properties:
- Select Menu
- Select Catalog Management
- Select Items
- Click the blue Edit button in the Action Column of the item you wish to enable
- On the Item Settings page, Enable the following options:
  - Show on Kiosk
  - Show on POS
  - Show on Online Ordering

For each item we enable, we will have to complete the following steps:

Add an image for the item aligned with the client's menu
Add a Display Name for the item, aligned with the client's menu
Map the item to a Category (configured in the previous step).

Ingredient Configuration

Because PAR Brink does not distinguish between Menu Items, Menu Selections, and Ingredients, we will need to do some manual configurations in the GRUBBRR Portal to ensure that modifiers can be appropriately mapped for the client's GRUBBRR Kiosk. We'll need to:

Disable the Ingredients as they were imported from PAR Brink
- Select Menu from the left sidebar
- Select Ingredient Management from the dropdown
- Select Selections
- From the Selection List page, you can disable modifiers manually by clicking on the green Status Button in the Action Column
Clone and Configure the Modifiers you'll be using:
- In the Action column, click on the black Clone button
- On the Clone Selection page:
  - Add an image for the modifier aligned with the client's menu
  - Add a Name for the modifier aligned with the client's menu
  - Make sure that the flag labeled Show on Kiosk is Enabled
  - Make sure that the flag labeled Show on POS is Enabled
  - Make sure that the flag labeled Show on Online Order is Enabled
  - Make sure that the flag labeled Ingredient is Enabled
  - Select Save

Common Modifier Configuration

When configuring custom modifier groups for PAR Brink clients- especially when the client has not configured a kiosk-ready menu in the PAR Portal- it's important to remember not to create new modifier groups from scratch. Doing so could lead to errors with External Reference IDs, causing orders to process incorrectly. Instead, we should use Clone and Configure to create new modifier groups. To do this:

Select Menu
Select Modifier Management
Select Common Modifiers
Select the black Clone button of the existing modifier group you wish to copy.
The cloned Modifier Group will automatically fill in a Custom External Reference ID and Modifier Name in Alt Lang. Leave these fields as is, but you can configure the following:
- Modifier Name
- Display Order
- Display Name
- KOT/KDS Display Order
- Min Selection
- Max Selection
- Max Portion
- Free Modifiers
- Mapped Ingredients
  - Note: Make sure you map the ingredients cloned in the GRUBBRR Portal to your modifier groups!

Custom Combo Configuration

The best Practices for Combos follow the same rules as Ingredients and Common Modifiers. If you need to create a new combo, you should start by cloning an existing combo to ensure that the Combo you are building has an appropriate External Reference ID. Remember: The combo will not show up on the GRUBBRR Kiosk unless all components are part of the channel menu we pulled.

For each ingredient that we wish to use as a modifier:
- Select Menu
- Select Catalog Management
- Select Combos
- Select the black Clone button of the Combo you wish to duplicate.
The cloned Combo will automatically import a valid Custom External Reference ID; leave this field alone, but you can now configure the Combo for display on the kiosk.
- Note: Do not edit prices manually, as these will be overwritten when syncing with the POS

Reviewing the Menu

After configuring the menu, review the items, categories, modifiers, and combos in the GRUBBRR Portal. Ensure that your configurations match the example menu that you received from the client.

Syncing with the POS

After you have configured the GRUBBRR Portal, you have two options for future syncs with the PAR Portal.

1. Save & Sync Menu: This option pulls item names, prices, categories, etc. from the client's PAR Portal. Items pulled in this way will need to be configured to display on the kiosk. To pull the client's menu:
  1. Log in to the GRUBBRR Portal at the location level
  2. Select Integration from the left sidebar menu
  3. Select PAR Brink POS from the dropdown menu
  4. Select Save & Sync Menu
2. Save & Sync Prices: This option pulls item price information only. This will not make any additional updates to the menu.
  1. Log in to the GRUBBRR Portal at the location level
  2. Select Integration from the left sidebar menu
  3. Select PAR Brink POS from the dropdown menu
  4. Select Save & Sync Prices

Procedure Warnings:

Prerequisites:

Before beginning the integration process for a client’s PAR Brink POS system, the client must contact their PAR Brink representative and request that GRUBBRR receive access to the location’s API.
Once the request has been processed, PAR Brink will send a group email to Development and Operations (via posaccess@grubbrr.com) with the following information:
- A Base URL
- A Location Token