About
DHL is a Marketplace integration that tracks DHL parcels in Home Assistant through the vendor's cloud. It can import parcels from a DHL account in Germany or Poland, track parcels by tracking code, or use a DHL tracking API key. It adds sensors for incoming parcels, next delivery, awaiting pickup, delivered parcels, outgoing parcels and the last successful update, plus a refresh button and a Deliveries calendar. Actions start or stop tracking a parcel by its number, and device triggers cover registered parcels, status changes, deliveries and changed delivery times. Options filter delivered parcels by days or count and can add a per-parcel status history, which is off by default. Setup is done in the UI, and the German account route needs a German IP address.
Automatic summary of the README and code of ha-parcel-integrations/ha-dhl. Something wrong, or are you the maintainer and want your own text here? Get in touch
Supports
Uses the vendor's cloud Needs an internet connection and an account with the vendor.
Device triggers Its devices can start automations directly.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.
Provides
- Sensors
- Calendars
Setting it up
Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.
Log in to a DHL account
- Country
Set up DHL (Germany)
- Redirect URL
Also asked when signing in again.
Set up DHL Parcel Polska
- Polish mobile number
Verify DHL Parcel Polska
- SMS code
Track with your DHL API key
- API key
Also asked when signing in again.
After setup
- Filter byShow delivered parcels from the last X days, or limit to the X most recent.
- AmountNumber of days or parcels to show.
- Include status historyAdd a per-parcel history attribute listing each status update (timestamp, status, original text). Off by default.
- Tracking codes
- Tracking codes
- Filter byShow delivered parcels from the last X days, or limit to the X most recent.
- AmountNumber of days or parcels to show.
- Include status historyAdd a per-parcel history attribute listing each status update (timestamp, status, original text). Off by default.
Texts from the code of ha-parcel-integrations/ha-dhl.
Entities
- ButtonsRefresh
- CalendarsDeliveries
- SensorsIncoming parcels, Next delivery, Awaiting pickup, Delivered parcels, Outgoing parcels, Outgoing delivered parcels, Last successful update
Actions
- Track parcelStart tracking a parcel by its DHL tracking number. On a DHL account it comes in addition to whatever the account already shows.Fields: Tracking code, DHL entry, Direction
- Untrack parcelStop tracking a manually-added DHL parcel by its tracking number.Fields: Tracking code, DHL entry
Troubleshooting
- DiagnosticsDownloads a diagnostics file to attach to a bug report.
From the README
📦 Part of ha-parcel-integrations, a family of package-tracking integrations for Home Assistant that all publish the same parcel format, statuses and events, so they plug into cross-carrier automations and the optional Parcel Aggregator. Browse the other carriers on the website.
💬 Questions or feedback? Join the discussion on the Home Assistant community.
- Automatic parcel import from your DHL Kundenkonto — no tracking codes to enter for your own parcels
- dhl.track_parcel / dhl.untrack_parcel services to add or remove a tracking number from an automation — on an account, for a parcel that is not (yet) in its inbox
- Per-parcel sensor with the canonical status (registered / in_transit / out_for_delivery / delivered / …), DHL's own status text, the expected delivery window and a tracking deep-link
- Summary sensors: incoming parcels, next delivery, recently delivered parcels, outgoing parcels
- Read-only Deliveries calendar with the expected delivery windows
- Events + device triggers for no-code automations (parcel registered, status changed, delivered, delivery time changed)
- Opt-in per-parcel status history
- Manual refresh button and a diagnostic last-update sensor
- Structure-preserving diagnostics export — the tool this pre-release is finished with (see Debugging)
Shows in Vulpo
Button card, Calendar card, Chart card, Apple Watch.Information
- Installs
- 133 sharing analytics
- GitHub stars
- 12
- Connection
- Uses the vendor's cloud
- Upkeep
- Updated in the last 6 months
- Version
- 1.7.1,
- Category
- Productivity and information, Shopping and groceries
- Kind
- Marketplace integration
- Needs
- Needs the Marketplace (HACS on 2026.10 and older)
- Domain
dhl- Issues
- Report an issue
