--- title: "PostNL" description: "PostNL is a Marketplace integration for Home Assistant. It has 293 installs sharing analytics, needs the vendor's cloud and was last updated October 23, 2026." canonical: "https://vulpo.app/integrations/marketplace/ha-parcel-integrations-ha-postnl" url: "https://vulpo.app/integrations/marketplace/ha-parcel-integrations-ha-postnl.md" last-updated: "2026-10-23" version: "1.4" --- # PostNL > PostNL is a Marketplace integration for Home Assistant. It has 293 installs sharing analytics, needs the vendor's cloud and was last updated October 23, 2026. 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](https://vulpo.app/contact) [Open in My Home Assistant](https://my.home-assistant.io/redirect/hacs_repository/?owner=ha-parcel-integrations&repository=ha-postnl&category=integration) On Home Assistant 2026.11 or newer? [Open it in the Marketplace](https://my.home-assistant.io/redirect/marketplace_repository/?owner=ha-parcel-integrations&repository=ha-postnl&category=integration) ## 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. ## 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 by**: Show delivered parcels from the last X days, or limit to the X most recent. - **Amount**: Number of days or parcels to show. ### After setup - **Filter by**: Show delivered parcels from the last X days, or limit to the X most recent. - **Amount**: Number of days or parcels to show. - **Include status history**: Add 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](https://github.com/ha-parcel-integrations/ha-postnl). ## Entities - **Buttons**: Refresh - **Calendars**: Deliveries - **Sensors**: Incoming parcels, Awaiting pickup, Outgoing parcels, Delivered parcels, Outgoing delivered parcels, Next delivery, En route to PostNL Point, Letters, Last successful update ## Troubleshooting - **Diagnostics**: Downloads 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 From the README of [ha-parcel-integrations/ha-postnl](https://github.com/ha-parcel-integrations/ha-postnl#readme), [MIT License](https://spdx.org/licenses/MIT.html). Shortened. ## At a glance - Kind: Marketplace integration - Category: [Productivity and information](https://vulpo.app/integrations/category/productivity-and-information.md), Shopping and groceries - Number: 293 installs sharing analytics; 20 GitHub stars - Connection: Needs the vendor's cloud - Upkeep: Updated in the last 6 months - Needs: Needs the Marketplace (HACS on 2026.10 and older) - Latest version: 4.10.3, last updated October 23, 2026 - Domain: `postnl` - Source: - Issues: In Vulpo: Button card, Calendar card, Chart card, Apple Watch Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation. [About these numbers](https://vulpo.app/integrations/about) Last updated 2026-10-23. Source: https://vulpo.app/integrations/marketplace/ha-parcel-integrations-ha-postnl --- - HTML version of this page: https://vulpo.app/integrations/marketplace/ha-parcel-integrations-ha-postnl - Site index for agents: https://vulpo.app/llms.txt - Everything in one document: https://vulpo.app/llms-full.txt - All pages: https://vulpo.app/sitemap.xml