1. Data Factory
  2. Order Shipment Event
POST
/data_factory/orderShipmentEvent
curl --request POST \
     --url https://sandbox.masonhub.co/dragonfly-cosmetics-demo/api/v1/data_factory/orderShipmentEvent \
     --header 'Authorization: Bearer <token>' \
     --header 'Content-Type: application/json' \
     --data '{
  "tracking_number": "<string>",
  "event": "<string>"
}'

Simulate carrier delivery events for existing shipments to test tracking and delivery workflows.

DataFactory is only available in the sandbox environment.

​
Request Body

tracking_number
required
string

Tracking number of the shipment to update.

event
required
string

Event type. Options: tendered, inTransit, delivered, undeliverable.

curl -X POST "https://app.masonhub.co/{account}/api/v1/data_factory/orderShipmentEvent" \
  -H "Authorization: Bearer your_jwt_token" \
  -H "Content-Type": "application/json" \
  -d '[{"tracking_number": "1z324897234nferg45", "event": "delivered"}]'
{
  "success": true,
  "data": [{"tracking_number": "1z324897234nferg45", "event": "delivered", "timestamp": "2024-01-14T16:00:00Z"}]
}

​
Available Events

1

Tendered

Package tendered to carrier for pickup
2

In Transit

Package is in transit to destination
3

Delivered

Package successfully delivered to customer
4

Undeliverable

Package could not be delivered

​
Testing Workflows

Test complete delivery lifecycle from fulfillment through delivery confirmation.