Package tracking in Home Assistant — PostNL, DHL, DPD, GLS + 40 more carriers

Johan_L · June 30, 2026, 4:52am

Any plans to support more providers like GLS NL & UPS.

ptnijssen · June 30, 2026, 1:48pm

@Johan_L I'll have a look; not sure if it's possible.

New releases are on the way for all carriers. You can now configure if you want the history to be also present within a parcel object. It's a normalized field. By default history is off and the value is null:

history: null

If you enable history, you get something like below, where status is the normalized status field and raw_status is the carrier specific status.

  history:
    - timestamp: '2026-06-29T00:45:08Z'
      status: registered
      raw_status: PRENOTIFICATION_RECEIVED
    - timestamp: '2026-06-29T01:30:02.349Z'
      status: in_transit
      raw_status: INTERVENTION_RECEIVER_REQUESTS_DELIVERY_AT_ANOTHER_TIME/DATE
    - timestamp: '2026-06-29T06:19:00Z'
      status: in_transit
      raw_status: PARCEL_SORTED_AT_HUB
    - timestamp: '2026-06-29T12:46:39Z'
      status: in_transit
      raw_status: PARCEL_ARRIVED_AT_LOCAL_DEPOT
    - timestamp: '2026-06-30T09:02:13Z'
      status: out_for_delivery
      raw_status: OUT_FOR_DELIVERY
    - timestamp: '2026-06-30T09:48:04Z'
      status: delivered
      raw_status: DELIVERED

@Klaptafeltje / @jonisnet might be interesting (or not) for the lovelace cards you have developed.

Johan_L · June 30, 2026, 4:18pm

Thanks,

They seem to have a not that complicated API, but only thing i can do is yell at ai what it's doing wrong

ptnijssen · June 30, 2026, 6:13pm

I prefer, when possible, a user account mechanism because then we can read the parcels in the account. Don't know if there is a my GLS account kind of way? Else you need to insert parcel codes every time

Also see Simple card · Issue #2 · peternijssen/ha-dhl-nl · GitHub

Johan_L · June 30, 2026, 6:38pm

Did some digging and there is no way to register. Probably only business account or something like that.

ptnijssen · June 30, 2026, 6:55pm

Would it already be helpful if you could insert GLS t&t codes in HA manually and then have the same options as the other carriers? If possible of course.

Trying to explore what is possible/doable

Klaptafeltje · July 1, 2026, 9:46am

Thanks! Added support for the timeline/history events in v1.1.0

ptnijssen · July 1, 2026, 3:31pm

To see what is possible with GLS, would someone be willing to follow the steps below and share the details with me through the chat option here? Note that you redact any personal information by replacing it with XXX for example.

What you need

A GLS-NL parcel number: 7 or 8 digits (this is the short number, not the long letters+digits barcode). You can usually find it in the GLS track & trace mail/SMS or on gls-info.nl.
The delivery postal code for that parcel, e.g. 1234AB (no space).

Open this URL in your browser, replacing the two placeholders:
```
https://apm.gls.nl/api/tracktrace/v1/PARCELNO/postalcode/POSTALCODE/details/nl-NL
```
Example (fake): https://apm.gls.nl/api/tracktrace/v1/12345678/postalcode/1234AB/details/nl-NL
You should see a page full of JSON ({ ... }).
- If the page is blank / "no content", the parcel number or postal code is wrong, or the parcel is too old — double-check both.
Select all (Ctrl/Cmd-A), copy, and send it back to me (redact any personal info).

Following this, I might need more info from different endpoints.

Johan_L · July 2, 2026, 5:07am

Just sended the details to you, just hit me up if you need anything else.

Also wondering if it would be possible to use a sensor of input_text or something like that to get the tracking numbers in the plugin.

Then people could use the email function of Home Assistant and just forward the received tracking emails.

ptnijssen · July 2, 2026, 6:51am

Thanks!

Here is a first initial alpha version. Same structure, sensors etc as the other carriers:

Since there is no account structure, you have to add T&Ts yourself. There is a service available that you can use to add tracking numbers by either adding an input field in your dashboard:

github.com/peternijssen/ha-gls

examples/dashboards/add_parcel_card.yaml

a85f2299a

# Add a GLS parcel straight from a dashboard — no diving into the options.
#
# The integration exposes two services:
#   - gls.track_parcel   (parcel_no, optional postal_code)
#   - gls.untrack_parcel (parcel_no)
#
# This example wires a text field + a button on a Lovelace card to
# gls.track_parcel. It needs one helper and one script (below), then the card.

# ---------------------------------------------------------------------------
# 1) Helper — Settings → Devices & Services → Helpers → Create → Text,
#    or in configuration.yaml:
# ---------------------------------------------------------------------------
input_text:
  gls_new_parcel:
    name: New GLS parcel number
    max: 20

# ---------------------------------------------------------------------------
# 2) Script — reads the text field, tracks the parcel, then clears the field.

This file has been truncated. show original

Or you can use an automation to of course trigger the service. Hope this helps in automating it as much as possible.

Let me know any bugs that you might come across

Johan_L · July 2, 2026, 7:55am

Added the packages via dev_tools, actions. This works so i assume it works in automations etc.. also.

All sensors seem to load the correct data and i added the sensors to HKI as a custom and that also works.

Do I need to untrack packages manual or will they disappear after a while?

ptnijssen · July 2, 2026, 4:06pm

Great! Delivered parcels will automatically be removed (the separate sensors). For the delivered sensor, I've just pushed an update that has the same config setting as all other carriers (amount of days or parcels you want to keep in "memory").

Johan_L · July 2, 2026, 5:14pm

In the git issue you referred to I noticed that there was also questions about ups.

Did you know that the ups basic tracking api is free to use for everyone with a ups mychoice account?

https://developer.ups.com/tag/Tracking?loc=nl_NL

Unfortunately not all dutch addresses are supported but if the shipper uses the linked email address the packages should appear.

Klaptafeltje · July 3, 2026, 12:48pm

Added beta-support for peternijssen/ha-gls:

bramdrijvers · July 13, 2026, 2:30pm

Is it possible to add multiple accounts for PostNL?

ptnijssen · July 13, 2026, 3:43pm

Yes, should be possible.

vloris · July 14, 2026, 8:47am

Hi!
I’m trying to install the package-tracker-card, and there is a small issue with the instructions in the README:
If you press the button “Open Hacs Repository on MyHA” on GitHub - klaptafel/ha-package-tracker-card: Custom Package Tracker Card for Home Assistant. · GitHub to add the repository to HACS, my Homeassistant gives me an errormessage:

I think the repository url in the button is incorrect?

Following the manual instructions does work.

Klaptafeltje · July 14, 2026, 12:50pm

Good catch. I made the mistake of adding category=dashboard to the link (just like you choose in the GUI), but it should be category=plugin. I will fix it, thanks!

ptnijssen · July 16, 2026, 5:24pm

Hi all! Couple of updates from my side here;

Repositories have been moved
I’ve moved all repositories to a dedicated organization; ha-parcel-integrations · GitHub
Which basically means that you can find all related material in a single place. You should not need to update the repo’s in HACS, but might be good to do anyway.

HACS support
All carriers will become available through HACS. Unfortunately there is a long queue in HACS to be accepted, but in the end they should all be added.

Dragonfly Shipping Support
Thanks to the great work from @Alwin_Hummels, we can very soon welcome Dragonfly Shipping to the family: GitHub - ha-parcel-integrations/ha-dragonfly: Home Assistant custom component for Dragonfly Shipping · GitHub
You can already add this in HACS if you want.

Bpost and UPS
I’ve been reviewing both BPost and UPS. I suspect we can add support at one point, similar to GLS and Dragonfly. I have to review it further. Especially for bpost, I need someone who has actual parcels or mail. You can sent me a DM if you want to collaborate.

ptnijssen · July 17, 2026, 5:20pm

Another great suggestion from the community: Automatically add GLS and Dragonfly shippings through imap / emails. See the open PR:

github.com/ha-parcel-integrations/ha-parcel-aggregator

docs: add e-mail → track_parcel example (IMAP + regex + optional AI fallback) (#5)

main ← HummelsTech:feature/email-tracking-example

geopend 05:02PM - 16 Jul 26 UTC

HummelsTech

+220 -0

Adds an *upstream* example to the collection: automatically extracting tracking …numbers from incoming shipping e-mails and registering them with code-based carriers (GLS, Dragonfly) via their `track_parcel` actions — so parcels appear in the aggregator the moment the shipping confirmation lands in the inbox. - `examples/automations/track_parcels_from_email.yaml` — the automation: `imap_content` trigger, cheap regex paths per carrier, optional `ai_task` fallback for forwarded/webshop mails (clearly marked deletable) - `examples/automations/track_parcels_from_email.md` — companion setup guide: IMAP entry configuration (multiple accounts/folders, Gmail app passwords) and the pitfalls we hit building this (Jinja backslash-escaping silently breaking regexes, the counter-intuitive `initial` flag semantics, message size truncation) - `examples/README.md` — a short third-pattern section pointing at both Running in production on my own instance — validated end-to-end with a real (forwarded) GLS mail, where the AI fallback extracted the correct parcel number while ignoring the decoy codes in the T&T links. Happy to adjust structure or naming to match where you want this to live in the org! 🤖 Generated with [Claude Code](https://claude.com/claude-code)

If someone willing to do some additional testing and report back here, I can review for a potential merge.