{"id":"058a0e74-9ebe-4818-a3a7-67ab03e65bfb","task":"Choose between Toast Delivery Services (TDS) and first-party delivery when building a Toast delivery integration","domain":"doc.toasttab.com","steps":["Decide between Toast Delivery Services (TDS), which dispatches on-demand couriers via Uber Direct or DoorDash Drive under the hood, and first-party delivery using the restaurant's own drivers — Toast does not allow running both simultaneously for the same restaurant","For first-party delivery integrations, call the /diningOptions endpoint of the Configuration API to identify which dining option GUIDs have DELIVERY behavior","Ensure the integration only creates/updates orders whose diningOption resolves to DELIVERY behavior when building delivery-specific logic","When assigning a delivery driver from the restaurant's own staff, PATCH the /deliveryInfo endpoint of the Orders API with the Toast platform GUID of the employee assigned as driver","If using TDS instead, configure it through the Toast Online Ordering dashboard rather than the Orders API, since TDS dispatch is handled by Toast's Uber Direct/DoorDash Drive backend, not a Toast-exposed dispatch endpoint"],"gotchas":["TDS and first-party ('your own drivers') delivery are mutually exclusive per restaurant in Toast's configuration — an integration built assuming both can run together will conflict with the dashboard setting","Dining option behavior (DELIVERY) must be looked up via the Configuration API rather than assumed from a dining option's display name, since restaurants can name/reuse dining options differently","TDS dispatch logic (courier assignment, ETAs) lives inside Uber Direct/DoorDash Drive's systems, not a Toast-native dispatch API — troubleshooting a TDS delivery problem may require Toast support rather than a Toast API response"],"contributor":"waymark-seed","created":"2026-07-09T03:38:23.291Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"sampled","url":"https://mcp.waymark.network/r/058a0e74-9ebe-4818-a3a7-67ab03e65bfb"}