Webhook Event Payloads

When subscribed to tracking events, you will receive a JSON payload each time a carrier provides a status update for a shipment.

Below is an example of a webhook payload:

UPS Sample Payload

Copy
Copied
{
  "carrier": "UPS",
  "carrierEventCode": "M",
  "carrierEventDescription": "Shipper created a label, UPS has not received the package yet.",
  "deliveryDate": "",
  "deliveryTime": "",
  "destinationAddress": {
    "city": "Beverly Hills",
    "country": "US",
    "description": "",
    "postalCode": "90210-4877",
    "stateOrProvince": "CA"
  },
  "estimatedDeliveryDate": null,
  "estimatedDeliveryTime": null,
  "eventCode": "PSR",
  "eventDate": "2025-08-08",
  "eventDescription": "Tracking details uploaded",
  "eventLocation": {
    "city": "",
    "country": "US",
    "description": "",
    "postalCode": "",
    "stateOrProvince": ""
  },
  "eventTime": "13:22:16",
  "packageStatus": "Manifest",
  "serviceCode": "518",
  "serviceName": "UPS Ground",
  "trackingNumber": "1ZJ4656E0320200543"
}

USPS Sample Payload:

Copy
Copied
{
  "carrier": "USPS",
  "carrierEventCode": "GX",
  "carrierEventDescription": "Shipping Label Created, USPS Awaiting Item",
  "deliveryDate": "",
  "deliveryTime": "",
  "destinationAddress": {
    "city": "Shelton",
    "country": "US",
    "description": "",
    "postalCode": "06484-4301",
    "stateOrProvince": "CT"
  },
  "estimatedDeliveryDate": null,
  "estimatedDeliveryTime": null,
  "eventCode": "PSR",
  "eventDate": "2025-08-08",
  "eventDescription": "Tracking details uploaded",
  "eventLocation": {
    "city": "BROOKLYN",
    "country": "",
    "description": "",
    "postalCode": "11201",
    "stateOrProvince": "NY"
  },
  "eventTime": "14:31:00",
  "packageStatus": "Manifest",
  "serviceCode": "001",
  "serviceName": "USPS Ground Advantage",
  "trackingNumber": "9400140105156006332686"
}