Skip to main content

Create Shipments

Shipment creation is the central write operation in the API.

Required inputs​

  • Partner-side order identifier
  • Sender and recipient details
  • Parcel dimensions and weight
  • Selected service level
  • Cash-on-delivery amount when applicable

Idempotency​

POSThttps://api.aquiline-tracking.com/v3/shipments

This endpoint requires an Idempotency-Key header. Reusing the same key for the same payload protects the integration from duplicate shipment creation during retries or network failures.

Returned identifiers​

On success, the API returns:

  • shipmentId for shipment management references
  • trackingNumber for partner and end-customer visibility
  • labelUrl when a label is available immediately

Operational recommendations​

  • Store the original request payload together with the idempotency key
  • Persist both identifiers in OMS and customer support tooling
  • Subscribe to webhook events instead of relying only on polling