Skip to main content

Delivery Simulator

The Delivery Simulator allows developers to manually walk a parcel through its entire lifecycle and trigger corresponding webhooks. This tool is part of the DoorDash Developer Portal.

What the Delivery Simulator does​

  • Simulates all major parcel states
  • Fires real webhook events to your configured sandbox endpoint
  • Allows testing of redelivery, returns, exceptions, and lost parcel flows
  • Helps QA confirm tracking UI and notification behavior

Supported Simulation Paths​

Happy Path:​

  1. Create Delivery → parcel_labeled
  2. Mid Mile Arrived → parcel_mid_mile_arrived
  3. Mid Mile Departed → parcel_mid_mile_departed
  4. Parcel Scanned → parcel_scanned
  5. Dasher Confirmed → (no webhook)
  6. Dasher Arrived at Pickup → (no webhook)
  7. Delivery Picked Up → dasher_picked_up
  8. Dasher Arrived at Dropoff → dasher_confirmed_dropoff_arrival
  9. Delivered → dasher_dropped_off

Redelivery Path:​

Includes:

  • Attempted Delivery → dasher_attempted_delivery
  • Receive to Redeliver → parcel_received_to_redeliver
  • Second attempt events

Return to Merchant Path:​

Final event: parcel_return_to_merchant

Lost in Transit Path:​

Event: parcel_lost_in_transit