About
PostNL is a Marketplace integration that tracks PostNL parcels and announced MyMail letters in Home Assistant. It connects to the vendor's cloud with a PostNL account, and Belgian accounts work for parcels while letter scanning is limited to the Netherlands. It adds sensors for incoming, outgoing, delivered and awaiting-pickup parcels, the next delivery, parcels heading to a PostNL Point, letters, and the last successful update. A calendar of deliveries, a refresh button and images of scanned letters are also provided. Device triggers cover events such as a parcel being registered, changing status or being delivered, and a letter being announced, so automations can start from them. Delivered parcels can be limited to the last few days or the most recent few, and an optional status history can be added to each parcel. Polling speeds up while parcels are out for delivery and pauses overnight.
Automatic summary of the README and code of ha-parcel-integrations/ha-postnl. 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.
PostNL
- Email address
- Password
Also asked when signing in again.
Delivered parcels
- Filter byShow delivered parcels from the last X days, or limit to the X most recent.
- AmountNumber of days or parcels to show.
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.
Texts from the code of ha-parcel-integrations/ha-postnl.
Entities
- ButtonsRefresh
- CalendarsDeliveries
- SensorsIncoming parcels, Awaiting pickup, Outgoing parcels, Delivered parcels, Outgoing delivered parcels, Next delivery, En route to PostNL Point, Letters, Last successful update
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.
- Incoming and outgoing active-parcel count sensors
- Per-parcel sensor per active incoming shipment, with full status details as attributes
- Optional per-parcel status history timeline (opt-in; off by default)
- Configurable delivered-parcels sensor (last N days, or N most recent)
- Next delivery datetime sensor (device class timestamp)
- PostNL Punt sensor — parcels destined for a PostNL Point pickup location
- MyMail letters sensor plus a per-letter image entity holding the scanned photo
- Automatic lifecycle management — per-parcel sensors are created and removed as parcels move through delivery
- Re-authentication support — silently refreshes the PostNL token, prompts only when the refresh fails
Shows in Vulpo
Button card, Calendar card, Chart card, Apple Watch.Information
- Installs
- 293 sharing analytics
- GitHub stars
- 20
- Connection
- Uses the vendor's cloud
- Upkeep
- Updated in the last 6 months
- Version
- 4.10.3,
- Category
- Productivity and information, Shopping and groceries
- Kind
- Marketplace integration
- Needs
- Needs the Marketplace (HACS on 2026.10 and older)
- Domain
postnl- Issues
- Report an issue
