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​

POST /shipments 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, Aquiline returns:

  • shipmentId for internal operational 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