How to Set up the HMS Host Integration in the GRUBBRR Portal

Last updated: August 5, 2026

HMS Host owns many restaurants within airports. At HMS’s request, GRUBBRR did not integrate with their POS devices. Instead, HMS creates middleware for each restaurant location, and GRUBBRR, in turn, can integrate with that piece of middleware that connects us to its associated POS systems.

Creating the menu and middleware for each location takes HMS a few weeks. 

Pulling HMS Host Menu

We can pull the menu once HMS creates the associated middleware for a location.

To pull the menu for an HMS location:

  1. Log in to the GRUBBRR Portal using HMS Host credentials
  2. Select Integration from the left sidebar menu
  3. Select HMS Host Middleware Integration from the dropdown
  4. In the Client ID field, enter 82B4E70D-B2F9-4573-AED2-7264E19B6C81
  5. In the Catalog URL field, enter https://unify.api.hmshost.com/v2/catalog/
  6. In the Order URL field, enter https://unify.api.hmshost.com/v2/order/ 
  7. In the Diagnostics URL field, enter https://unify.api.hmshost.com/v2/diagnostics/services/status
  8. In the Client Username field, enter hms.integration@grubbrr.com 
  9. In the Client Password field, enter f!f;5';vWra6=Qa>
  10. In the OrderPrefix field, enter HMS
  11. In the Subscription Key field, enter 38967a5d1e254c678006ce1d57ef581c
  12. In the Default Order Type field, enter 2
    • NOTE: In HMS' system, Order Type 1 refers to Dine In orders, and Order Type 2 refers to Take Out. We want to set Take Out as the default order type for HMS clients. 
  13. In the Default Tip ID field, enter 2
  14. Select the Concessionaire Configuration Type
    1. Multiple Revenue Center Single Concessionaire: This is for cases where revenue is not being funneled to one restaurant location
      • Note: For this configuration, customers can only order from one concessionaire at a time on the kiosk
    2. Single Revenue Center Multiple Concessionaires: This is for cases where all revenue is collected by kiosks at a central location. 
  15. Enter Concessionaire Information into the table 
    • Concessionaire Name,
    • Property ID, and
    • Revenue Center ID will all be provided by HMS Host
  16. If the client wants to schedule a full Daily Sync, you can enable this function and assign it a time. This would be in addition to the automatic syncs required by HMS Host (see note below).
  17. Enable Ignore Display Name
  18. Use the following Tender IDs in the Tender Mapping table   

  19. Select Save & Sync Data Now

Important Note:

HMS Host Middleware does not offer webhooks for Item 86 status updates; our integration partnership requires GRUBBRR to perform hourly syncs with the HMS system.  We perform these syncs every thirty minutes, at :15 and :45 after every hour.  After each sync, our system will automatically update to reflect any menu changes we find. 

Menu Management

The menu should always be managed on the HMS Host side. GRUBBRR can make cosmetic edits, but these changes should remain relatively minor due to the nature of integrations. 

Specifically, we can override display names, orders, and images. If needed, we can create custom categories; however, we need to ensure that our menu accurately reflects the client's POS when doing so. 

Troubleshooting

A couple of unique scenarios can occur with the HMS integration.

  • Issue: Transactions receiving error messages and being refunded
    • This refers to the ‘Uh Oh! We have encountered an error while submitting your order. Your transaction has been refunded. Please proceed to the counter to place your order’ error message.
    • When this occurs, we did not receive a success signal from the middleware. This could occur for various reasons, including the middleware or POS being offline. 
  • Issue: Error message at the start of a transaction
    • HMS requested we develop a health check at the beginning of transactions. If the health check fails, an error message to try again later will appear.
    • If this occurs, the middleware or POS may be offline.


Procedure Warnings:

To allow GRUBBRR devices to pull menus from and push orders to HMS Host's point of sale systems.