Tutorial · Beginner · 10 min

Connect your POS in 10 minutes

Walk through a Toast integration end-to-end: OAuth, location selection, category mapping, first sync.

Prerequisites
  • Owner or Admin role
  • Toast admin credentials (or equivalent for another POS)
What you will build
  • A live Toast integration that pulls items, modifiers, and prices.
  • Category mappings between Toast and MenuList widgets.
  • Automatic 86 behavior — items hidden the moment Toast marks them out-of-stock.
  1. 1

    Start the connection

    Dashboard → Integrations → Toast → Connect. The OAuth dialog from Toast opens. Sign in with the Toast admin account.

  2. 2

    Pick locations

    After auth, MenuPi shows every Toast location you have access to. Tick the ones you want to sync. Each location can be linked to a MenuPi Location.

  3. 3

    Map categories

    MenuPi auto-suggests mappings (Toast "Beverages" → MenuList "drinks"). Review and override where the suggestion is wrong.

  4. 4

    Run initial sync

    Click "Run initial sync". Sync takes 30s–2min. Items appear in the Content view as they land.

  5. 5

    Verify 86 behavior

    In Toast, mark a low-importance item as 86'd. Within 60 seconds the item should drop off every menu board running a MenuList widget mapped to that category.

    Shell
    Or trigger a manual sync from CLI
    menupi pos sync toast
Up next
← Back to all tutorials