Help CenterGetting set up

Connect Toast POS delivery orders

Connect one Toast restaurant location to Routella, import Delivery orders automatically, and see whether the signed webhook and five-minute backup check are working.

What it is

Toast Native is Routella's direct connection to the official Toast API. Each connection belongs to one exact restaurant location. Routella imports only orders that Toast marks with a dining option whose behavior is Delivery. Pickup, takeout, dine-in, canceled, deleted, and voided orders are not added as new deliveries. Repeated updates use the same Toast order ID, so they update one Routella order instead of making duplicates.

Why it matters

A Toast delivery arrives on the same Routella board as every other delivery. You can add it to a route, send the driver and customer links, collect proof of delivery and a signature, print labels, and include it in reports without copying the customer, address, items, total, target time, or notes by hand.

Step by step

1
Create access for one Toast location
In Toast Web, create API credentials for the exact restaurant location. Give the API client orders:read, config:read, delivery_info.address:read, and guest.pi:read. restaurants:read is recommended because it lets Routella confirm the location name and settings.
2
Open Toast in Routella
Open Integrations, press Connect a store, search for Toast, and choose it. Give the connection a clear name such as Main Street or Airport location so locations never get mixed up.
3
Paste the location details
Paste the API access URL Toast gave you, Client ID, Client Secret, and the Restaurant / Location GUID. Leave the webhook signing secret empty if Toast has not created the webhook subscription yet.
4
Test and connect
Press Test & Connect. Routella checks the official Toast sign-in, the required permissions, the exact location, its Delivery dining options, and a small orders read. A failed test does not keep a broken connection.
5
Finish the signed webhook
The success panel shows a Toast Orders webhook URL. In Toast Web, create an Orders webhook subscription for this exact location and paste that URL. Copy the signing secret Toast gives you, return to Manage Toast, paste it into Webhook signing secret, and press Save & test connection.
6
Check the backup and recent runs
Manage Toast shows the location, permissions, Webhook state, Polling fallback, last successful sync, and recent run counts. Polling fallback checks every five minutes even before the webhook is finished. Sync now runs the same safe importer immediately and cannot overlap another run for that location.
7
Use the normal Routella delivery flow
Imported Toast deliveries appear on the regular order board. Build routes, send driver and customer links, collect proof and signatures, print labels, and use reports exactly as you do for other Routella orders.

Tips

Connect each Toast location separately and label it clearly.
If Webhook says Waiting for signing secret, scheduled polling is still importing deliveries every five minutes; finish the webhook so updates can arrive sooner.
Standard Toast API access is read-only. Write delivered status back to Toast stays disabled unless Toast grants orders.delivery_info:write and you explicitly turn it on.
Disconnecting stops Routella immediately, but you should also remove Routella's Orders webhook subscription in Toast Web.

Common questions

Do you integrate with Toast, or do I need to enter every delivery manually?

Routella has a direct Toast connection built on Toast's official API. Once an authorized restaurant user connects the selected location, active Delivery orders flow into Routella automatically. If you do not connect Toast, you can still create a delivery by hand on a tablet or computer and then build or assign its route. Routella provides a secure driver link and a separate customer tracking link, and the delivery can use proof of delivery, optional signature capture, printable delivery labels, and reports.

Which Toast orders does Routella import?

Only orders whose exact Toast dining-option GUID belongs to an option whose behavior is Delivery. Pickup, takeout, dine-in, canceled, deleted, and voided orders are ignored as new deliveries.

Will the same Toast order be imported twice?

No. Routella keeps the Toast order GUID as its permanent source ID. Webhook repeats, polling overlap, and later updates all point to the same Routella order.

What arrives from Toast?

The Toast order ID and number, customer name, phone, email, delivery address, promised time, items, quantities, prices, total, payment hint, delivery instructions, and item notes when Toast supplies them. A Delivery order without a usable address is held out of routes and shown as a partial sync problem.

What Toast access does Routella need, and how do you protect our privacy?

The restaurant chooses the exact location and creates a read-only Standard API connection in Toast Web. Only active Delivery orders are created as new Routella deliveries, using the customer contact details, delivery address, promised time, items, totals, and notes needed for the delivery workflow. Pickup, takeout, dine-in, canceled, deleted, and voided orders are not added as new deliveries. Routella encrypts the client secret and webhook signing secret and excludes both from sync logs. The restaurant can disconnect Routella and can rotate or remove the Toast credentials at any time.

Do we need Toast approval or a sandbox before connecting?

For normal read-only Standard API access, an active employee of the Toast location with Manage Integrations permission and Toast Restaurant Management Suite Essentials or higher creates the credentials directly in Toast Web. Standard access has no sandbox, so Test & Connect and the first controlled test use the restaurant's real Toast location. Toast partner approval is still required before Routella can claim Toast partner or certified status, use a partner sandbox, or receive extra write access.

Does Routella change my Toast order?

Not with normal Standard API access. Optional writeback appears only when Toast has officially granted orders.delivery_info:write and you turn it on. Then Routella sends only Delivered and the delivered time after a full delivery completes; it does not change payment, items, totals, notes, or the whole order status.