Webhook

Instead of polling the API repeatedly to check for status changes, Webhooks let Track123 push updates to your server the moment a shipment milestone occurs. This is the recommended approach for building real-time integrations.

How it works

1. You provide an HTTPS endpoint on your server
2. Track123 sends a POST request to that endpoint whenever a tracked shipment changes status
3. Your server processes the payload and responds with HTTP 200

Add a Webhook

1. Go to Developer → Webhook in the left navigation
2. Click Add Webhook
3. Enter your endpoint URL (must be HTTPS)
4. Select the event types you want to receive
5. Click Save

Your Webhook will appear in the list with its URL, last notification time, and QPS (queries per second) limit.

Webhook events

Track123 sends a Webhook notification when a shipment transitions to any of the following statuses:

Event	Trigger
info_received	Carrier acknowledges the shipment
in_transit	Shipment begins moving through the carrier network
out_for_delivery	Shipment is on the final delivery vehicle
waiting_for_pickup	Shipment is held at a pickup location
delivered	Shipment is successfully delivered
exception	An abnormal event occurs
failed_attempt	A delivery attempt was unsuccessful
expired	No update received for an extended period

Full details→