This guide will be removed on April 29, 2022. Please use our new, easier-to-use Toast technical documentation site. All updated content is on the new site.

Setting promisedDate for a future order

The promisedDate value for an order sets the date and time to fulfill the order. When you include the promisedDate value, the order you create is scheduled for that date and time.

If you do not include a promisedDate value, the Toast platform creates an as soon as possible (ASAP) order for immediate fulfillment.

When you set promisedDate, make sure that the date and time reflects the required preparation times and the restaurant hours. For restaurants that use Toast Online Ordering, you must also consider the specific time frames when the restaurant accepts online orders. A restaurant can also limit how far in the future you can schedule an order.

For example, if an order takes 45 minutes to prepare, do not set promisedDate for a delivery order to 15 minutes after the restaurant starts to accept delivery orders.

For information on how to estimate the wait time for an order, see Calculating order wait time.