Skip to main content
All CollectionsLunchbox 1.0LB 1.0 IntegrationsLB 1.0 Toast Documentation
(LB 1.0) Toast Integration & API Access Email Walk Through
(LB 1.0) Toast Integration & API Access Email Walk Through
Jeiah Isles avatar
Written by Jeiah Isles
Updated over 9 months ago

Toast POS Integration:

In order for Lunchbox online orders to populate properly (and for all reporting to be correct), Lunchbox must be set up to integrate with Toast. In order to do that, Lunchbox needs to be granted access to your Toast Dashboard. The following actions MUST be completed in order to start configurations:

Loyalty Config Request Guidelines

  • Timeline: If you have a customer that needs their loyalty re-configured to Lunchbox at a specific date/time, please ensure that you submit the API Email request to the Integrations Support team <[email protected]> at least 3 business days ahead of that date/time. Note that configuration changes can only be done Monday-Friday between 9am-7pm ET by Integrations Support.

  • Subject Line: To help the Integrations Support team easily recognize these types of requests from Lunchbox, please use a subject line that includes keywords: "Loyalty Enablement Scheduling Request"

  • Information to Include: GUID(s), location name(s), and address(es) of the location(s) needing to be configured. Additionally, please specify the time zone when requesting the date/time for re-config.

Toast API Access Email:

Step 1: Email Toast requesting Lunchbox API Access at [email protected] - this can be found on the General Ops tab in your restaurant-specific Configuration Workbook located in your Google Drive.

Note: If you are not using Lunchbox Loyalty or Scan to Pay you can stop here. Otherwise proceed to the next portion of documentation. DO NOT SEND THE EMAIL IF YOU ARE NOT USING LUNCHBOX LOYALTY OR SCAN TO PAY THIS COULD CAUSE OTHER INTEGRATION ISSUES IF THESE ARE ACCIDENTALLY ENABLED.

Step 2: Next the restaurant partner must edit and send the following email to Toast Support to grant API access to the Loyalty API and Tender API.

Note: A restaurant partner’s Delivery Manager will send them the email template below to ensure we have proper API access.


FOR TOAST SCAN TO PAY & LUNCHBOX LOYALTY

To grant Lunchbox access to the Tender & Loyalty API, please send an email to the API team at Toast using this template:

CC: {your CSM / Delivery Manager & Paul Zarmati [email protected]}

--

Subject: "Lunchbox V1 API Enablement Scheduling Request including Loyalty & Tender"

--

Body:

Hello,

We give permission for the Lunchbox Team to have access to our Toast Data Set. We will be onboarding to Lunchbox V1 on (Date & Time with Time Zone)

Please enable the following:

  • Configuration API

  • Menus API

  • Orders API

  • Restaurants API

  • Stock API

  • Order management configuration API

  • Partners API

  • Tender API

  • Loyalty API (Please confirm the Loyalty API is enabled)

This request will grant the Lunchbox team API access to all our locations on Toast for Production and Sandbox, as well as the Toast sandbox dashboard.

[Using your configuration workbook copy and paste the following location details here.

  • Location Name

  • Location Address

Thank you,

{customer_Name}


FOR TOAST SCAN TO PAY ONLY NO LUNCHBOX LOYALTY

To grant Lunchbox access to your tender API ONLY, please send an email to the API team at Toast using this template:

CC: {your CSM / Delivery Manager & Paul Zarmati [email protected]}

--

Subject: "LLunchbox V1 API Enablement Scheduling Request including Tender"

--

Body:

Hello,

We give permission for the Lunchbox Team to have access to our Toast Data Set. We will be onboarding to Lunchbox V1 on (Date & Time with Time Zone)

Please enable the following:

  • Configuration API

  • Menus API

  • Orders API

  • Restaurants API

  • Stock API

  • Order management configuration API

  • Partners API

  • Tender API

This request will grant the Lunchbox team API access to all our locations on Toast for Production and Sandbox, as well as the Toast sandbox dashboard.

[Using your configuration workbook copy and paste the following location details here.

  • Location Name

  • Location Address

Thank you,

{customer_Name}


FOR LUNCHBOX LOYALTY ONLY NO SCAN TO PAY

To grant Lunchbox access to Loyalty API Only, please send an email to the API team at Toast using this template:

CC: {your CSM / Delivery Manager & Paul Zarmati [email protected]}

--

Subject: "Lunchbox V1 API Enablement Scheduling Request including Loyalty"

--

Body:

We give permission for the Lunchbox Team to have access to our Toast Data Set. We will be onboarding to Lunchbox V1 on (Date & Time with Time Zone)

Please enable the following:

  • Configuration API

  • Menus API

  • Orders API

  • Restaurants API

  • Stock API

  • Order management configuration API

  • Partners API

  • Loyalty API

This request will grant the Lunchbox team API access to all our locations on Toast for Production and Sandbox, as well as the Toast sandbox dashboard.

[Using your configuration workbook copy and paste the following location details here.

  • Location Name

  • Location Address

Thank you,

Thank you,

{customer_Name}


Notes:

  • This template should be customized for the specific restaurant group.

  • Please CC the Client Success Manager (CSM) & Delivery Manager on the email.

  • This API setup must be completed within one day of project kick-off. If your location is delayed immediately reach out to your Delivery Manager to request access.

Step 3: Once the Restaurant’s request has been granted, an email will be sent from Toast to [email protected]. The email will look like this and contains the locations GUID.

toastemail.png

When a restaurant partner is opting into Lunchbox Loyalty it is important to remember that the Toast Loyalty API has to be set to active and Lunchbox needs to be granted access to the Toast Loyalty API. This will enable the Rewards Button for scanning loyalty and manual entry purposes. If you are experiencing errors check that this is complete with your Toast Rep.

Did this answer your question?