Webhooks: Payload Fields
Every DashLink webhook contains a JSON payload with metadata describing the parcel's current state. Fields may be omitted if no data is available at that time.
Core Fields
| Field | Description | Available For |
|---|---|---|
| contactless | Whether the delivery was contactless | All events |
| created_at | Timestamp when the webhook was created | All events |
| currency | Currency for fee/tip/order_value | All events |
| event_name | Name of the triggered event | All events |
| external_delivery_id | Tracking code for the parcel | All events |
| order_value | Value of the goods shipped (cents) | All events |
| fee | Delivery fee charged | All events |
| updated_at | Timestamp when delivery info last updated | All events |
| description | Human-friendly description of event | All events |
Dasher & Vehicle Fields
| Field | Description |
|---|---|
| dasher_id | Unique ID of the dasher |
| dasher_name | First name and last initial |
| dasher_dropoff_phone_number | Phone number to contact dasher at dropoff |
| dasher_pickup_phone_number | Phone number to contact dasher at pickup |
| dasher_location | Dasher lat/lng |
| dasher_vehicle_make | Make of the dasher’s vehicle |
| dasher_vehicle_model | Model of the vehicle |
| dasher_vehicle_year | Year of the vehicle |
Pickup & Dropoff Fields
| Field | Description |
|---|---|
| pickup_address | Merchant’s origin address |
| pickup_instructions | Instructions for pickup |
| pickup_phone_number | Contact phone for pickup issues |
| pickup_reference_tag | Tracking code variant used internally |
| dropoff_address | Final destination address |
| dropoff_phone_number | Phone number to contact recipient |
| dropoff_instructions | Delivery instructions |
| dropoff_contact_given_name | Recipient first name |
| dropoff_contact_family_name | Recipient last name |
| dropoff_contact_send_notifications | Whether SMS notifications are enabled |
Time Fields
| Field | Description | Available |
|---|---|---|
| pickup_time_actual | When package was picked up | After pickup |
| pickup_time_estimated | Estimated pickup time | All events |
| dropoff_time_actual | When package was delivered | After DASHER_DROPPED_OFF |
| dropoff_time_estimated | Estimated delivery time | All events |
| return_time_actual | When returned to facility | Return events |
Proof of Delivery Fields
| Field | Description |
|---|---|
| dropoff_verification_image_url | POD photo; valid 7 days |
| dropoff_signature_image_url | Signature image, if applicable |
| pickup_verification_image_url | Pickup verification image (peer-to-peer only) |
Exception & Failure Fields
| Field | Description |
|---|---|
| undeliverable_reason_code | Reason for failed attempt |
| undeliverable_reason_additional_details | Additional notes from dasher |
| return_reason | Reason for return-to-merchant |
| parcel_delayed_reason | Reason for delayed status |
| parcel_awaiting_reason | Reason for awaiting status |
Location Metadata
| Field | Description |
|---|---|
| package_location.city | City where event occurred |
| package_location.state | 2-letter state |
| package_location.zip_code | ZIP code |
| package_location.timezone | Time zone of event |
Tracking
| Field | Description |
|---|---|
| tracking_url | Customer-facing tracking URL |
| support_reference | Reference for support cases |