Export menus and orders from Toast via its API

Steps

1. Authenticate using Toast's partner API credentials; obtain a short-lived access token from the Toast authentication endpoint using your client_id and client_secret
2. Fetch menu data by calling GET /menus/v3/restaurants/{restaurantGuid}/menus — this returns the full menu hierarchy including categories, menu groups, items, modifier groups, and modifier options in a single response
3. For order export, call GET /orders/v2/orders with the required restaurantGuid header and optional filter parameters such as startDate, endDate, and pageToken for pagination
4. Parse the Order objects to extract line items, modifiers, payment details, and tips; use the displayNumber field for human-readable order references
5. Use webhooks (available via Toast's webhook configuration) to receive real-time order events rather than polling for high-volume integrations
6. Store the guid values for menu entities to map order line items back to menu items during reconciliation