Skip to main content

Create Delivery

POST /drive/v2/deliveries is the core endpoint used to create a parcel in DashLink. It is functionally identical to accepting a quote, except it does not allow a preview of the fee or serviceability beforehand.

Endpoint​

POST /drive/v2/deliveries

This endpoint:

  • Creates an active parcel delivery
  • Generates or confirms the tracking code
  • Validates the full request payload
  • Triggers address correction
  • Returns a base64 shipping label
  • Initiates the delivery lifecycle

See the Drive API Reference for the full schema.

Required fields (high-level summary)​

According to the parcel guide, these fields are required:

  • order_fulfillment_method: "parcel"
  • pickup_external_business_id
  • origin_facility_id
  • dropoff_address
  • dropoff_contact_given_name
  • dropoff_contact_family_name
  • dropoff_phone_number
  • dropoff_address_components (street, unit, city, state, ZIP, country)
  • items[] array with:
    • name
    • description
    • external_id
    • quantity = 1
    • height, width, length, weight
  • order_value
  • currency = "USD"

Response fields (high-level)​

Returned values include:

  • Final tracking code (external_delivery_id, pickup_reference_tag, items[].barcode)
  • Address validation output (dropoff_address_components)
  • Estimated delivery times
  • Fee
  • Tracking URL
  • Shipping label (if enabled)

Labels are:

  • PDF 4×6
  • ZPL 203 dpi
  • ZPL 300 dpi

When to use create-delivery directly​

Use this endpoint instead of quotes when:

  • You already trust your serviceability logic
  • You don’t need to preview fees
  • You want to simplify your integration to a single step
  • You run a synchronous realtime workflow