Receive DHL Express push tracking notifications via webhook

Steps

1. Register for access to the DHL Shipment Tracking Unified Push API on the DHL API Developer Portal (developer.dhl.com) and obtain an API key.
2. Create a subscription by POST-ing your HTTPS callback URL and the shipment identifiers (shipment ID or account ID) to the subscription endpoint; the API returns a subscription ID and a secret.
3. Activate the subscription using the subscription ID and secret in a follow-up activation call as documented in the DHL Push API 101 guide.
4. On each inbound push, parse the JSON payload for status events, location updates, and estimated delivery time; acknowledge with HTTP 200 to prevent retries.
5. Handle DHL's retry schedule: if delivery fails, DHL retries after approximately 1 hour, then approximately 6 hours; after the third failed attempt no further retries occur and a technical contact is notified by email.
6. Monitor the subscription health endpoint or error notifications to detect silently dropped subscriptions and recreate them proactively.