Skip to content
Webhooks/Tracking/
Tracking Update

Tracking Update
Webhook

Request

A webhook that is triggered when one or more tracking updates are received from the carrier.

Bodyapplication/json
event_typestring, <= 255 charactersrequired

The type of event that triggered the webhook.

Example:"tracking_update"
event_idstringrequired

A unique identifier for the event.

Example:"AB12C3"
payload_versionstring, <= 10 charactersrequired

The version of the payload schema.

Example:"2026.1"
carrier_slugstring, <= 50 characters

The slug of the carrier that provided the tracking update.

Example:"dhl"
countinteger

The number of packages (tracking updates) in the response.

Example:1
trackingsArray of objects(TrackingUpdates)
POST
TrackingUpdate
Payload
{
  "event_type": "tracking_update",
  "event_id": "AB12C3",
  "payload_version": "2026.1",
  "carrier_slug": "dhl",
  "count": 1,
  "trackings": [
    { … }
  ]
}

Responses

Return a 200 response to acknowledge receipt of the webhook.