Toast POS Integration Guide

Overview

The Toast POS integration lets your AI bot answer guest questions about menus, hours, promotions, dietary options, and table orders — directly from your Toast system, without involving front-of-house staff.

Requires: Toast POS subscription, Pro plan or higher. Go to Integrations → Toast POS to connect.

Setup

Enter your Toast Client ID, Toast Client Secret, and Restaurant GUID in the Toast POS settings page. The bot authenticates using machine-client OAuth and refreshes its access token automatically — no manual token management needed.

To find your Restaurant GUID: log into the Toast Web App → Restaurants → click your location → copy the GUID from the URL.

Menu and Item Tools

Get Menu Categories

The bot can list all top-level menu categories (Appetizers, Entrees, Desserts, Drinks, etc.) so guests know what sections are available before diving into specifics.

Triggers: "What's on the menu?", "What sections do you have?", "What categories are available?"

Search Menu

Searches your full menu by keyword or ingredient. Returns matching items with price and description.

Triggers: "Do you have pasta?", "What has avocado?", "What's on your gluten-free menu?"

Get Menu Item Detail

Returns full detail for a specific menu item — price, description, allergen info, and available modifiers.

Triggers: "Tell me about the Caesar salad", "What's in the BBQ burger?", "How much is the ribeye?"

Get Modifiers

Returns all customization options for a menu item — sizes, add-ons, substitutions, toppings — with any additional pricing per option.

Triggers: "Can I add avocado?", "What sizes does the coffee come in?", "What toppings can I add to the pizza?"

Get Items by Dietary Tag

Finds menu items that match a dietary preference or label: vegan, vegetarian, gluten-free, dairy-free, nut-free, etc.

Triggers: "What vegan options do you have?", "Any gluten-free dishes?", "What can I eat if I'm lactose intolerant?"

Get Daily Specials

Returns featured items, daily specials, and seasonal offerings currently marked as specials in Toast.

Triggers: "What are today's specials?", "Any featured items?", "What's the special tonight?"

Get Allergen Info

Finds menu items that include or exclude a specific allergen keyword — nuts, shellfish, dairy, gluten, eggs, soy, etc.

Triggers: "What's nut-free?", "I'm allergic to shellfish, what can I eat?", "What doesn't have dairy?"

Restaurant Info Tools

Get Restaurant Info

Returns the restaurant's name, address, phone number, and general description from Toast.

Triggers: "Where are you located?", "What's your phone number?", "How do I reach you?"

Get Hours

Returns current operating hours including any holiday or special hours configured in Toast.

Triggers: "What time do you open?", "Are you open on Sunday?", "What are your hours today?"

Get Restaurant Services

Returns which ordering modes are currently enabled: dine-in, takeout, curbside, delivery, and online ordering.

Triggers: "Do you do delivery?", "Can I order takeout?", "Do you have curbside pickup?", "Do you take online orders?"

Get Discounts and Promotions

Returns all active discounts and promotions currently configured in Toast — including happy hour, loyalty discounts, fixed-amount and percentage-off promotions.

Triggers: "Do you have any discounts?", "Is there a happy hour?", "What promotions do you offer?", "Do you have a loyalty discount?"

Order and Table Tools

Get Table Order (Staff Use)

Looks up the active open order for a specific table number. Shows order number, time opened, current total, and status.

Best for: Staff-facing bots where servers can quickly check a table's bill without opening the POS terminal.

Triggers: "What's on table 5's order?", "Check the bill for table 12", "What has table 8 ordered?"

Get Order by ID

Looks up a specific order by its Toast order ID — useful for confirming pickup or delivery orders by order number.

Triggers: "What's the status of order #12345?", "Can you look up my order?"

Shift Info Tool

Get Current Shift Info

Returns which employees are currently clocked in. Useful for staff-facing or manager-facing bots.

Requires: Toast labor API permissions must be enabled for your API credentials.

Triggers: "Who's working right now?", "How many staff are on shift?", "Is Sarah clocked in?"

Troubleshooting

See the Integration Troubleshooting Guide for Toast-specific auth errors, missing permissions, and configuration steps.

Tips for Best Results

• Dietary queries work best when your Toast menu items have dietary tags or properties set in the Toast menu editor.
• Modifier queries require that modifier groups be attached to menu items in Toast — items without modifiers will return an empty result.
• Labor/shift info requires the Toast labor API scope in your API credentials — standard menu-only credentials won't include it.
• Table orders are most useful when the bot is deployed in a QR-code or table-side chat context, not a public web chat.