Simulate deliveries for testing
This doc covers the Drive API. If you're using the Drive (classic) API, see the how-to guide for simulating Drive (classic) deliveries.
The Delivery Simulator is for testing your application and creates simulated deliveries. Deliveries created in the Delivery Simulator are for testing purposes, and therefore, not dispatched to dashers. Therefore, if you need to test webhooks for these deliveries, you will need to transition the states of each delivery individually from the Delivery Simulator.
Using the delivery simulator
The delivery simulator allows you to easily create new test deliveries and update the state of a recently created delivery. After each state change, the status of the delivery should reflect the state in the API response. In Drive (classic), you will also receive webhook payloads with each state change.
Creating a test delivery
There are two way to get a delivery into the delivery simulator:
- Create a delivery through the user experience.
- Create a delivery through the API using a sandbox key.
Updating the state of a delivery
The delivery can be updated to any of the valid next states. The dropdown will populate with the states which are valid.
- Dasher confirmed
- Dasher Arrived at Pickup
- Delivery Picked Up
- Dasher Arrived at Dropoff
Other important notes
- Test deliveries will get automatically cancelled after one hour.
- Not all valid webhooks (classic only) are able to be simulated.