# \[APP\]\[Pro\] PostNL for Homey **URL:** \ **Category:** Apps\ **Tags:** app, tools, homey-pro, widgets\ **Created:** [September 16, 2026, 3:58pm UTC](https://community.homey.app/t/app-pro-postnl-for-homey/159674 "2026-09-16T15:58:18Z")\ **Posts on this page:** 1\ **Showing post:** 1
**Author:** ![LRvdLinden](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/lrvdlinden/32/80786_2.png) [@LRvdLinden](https://community.homey.app/u/LRvdLinden)\ **Post date:** [September 16, 2026, 3:58pm UTC](https://community.homey.app/t/app-pro-postnl-for-homey/159674/1 "2026-09-16T15:58:18Z")
![xlarge](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/6/f/6fb6d5bf0d8e2824af54a1042c01d87fcdc481da.jpeg) # **PostNL for Homey** View expected mail items and PostNL parcels directly in Homey. The app uses PostNL’s personal, non-public interfaces. Because these interfaces are not officially intended for third-party applications, changes by PostNL may occasionally require an app update. PostNL for Homey provides a dedicated **My PostNL** device with capabilities, Flow cards, Flow tokens and widgets for both mail and parcels. ### Linking your PostNL account 1. In Homey, go to **Add Device → PostNL → My PostNL**. 2. Enter the **email address** and **password** you use for the PostNL app or website. 3. Homey signs in directly with PostNL and securely stores the resulting authentication session. 4. After a successful login, your **My PostNL** device is created automatically. If your PostNL session expires, open the device and use **Repair** to sign in again. > **Important:** Use the same email address and password that you use for the official PostNL app or website. Your PostNL password is only used to authenticate with PostNL. Never share your PostNL credentials, access tokens or refresh tokens with anyone. * * * ## Widgets PostNL for Homey includes four widgets: ### **My Post** Shows your currently announced mail items, including available mail scans. ### **My Packages** Shows your current and recent PostNL parcels with sender, status and delivery information. ### **My Delivery** Shows the active delivery, including the official PostNL status, delivery window and delivery progress. ### **Parcel Journey** Shows the full Track & Trace journey of the active parcel, including previous PostNL status events. * * * ## Parcel information The **My PostNL** device exposes detailed parcel information through device capabilities and Flow tokens, including: - Official PostNL parcel status - Canonical parcel status - Observation code - Sender - Receiver - Tracking number - Delivery date - Delivery window - Latest parcel event - Parcel status timestamp - Delivered status - Shipment type - Parcel weight in grams - Parcel weight in kilograms - Parcel dimensions - Parcel length - Parcel width - Parcel height - Pickup / PostNL Point status - Pickup-point information when supplied by PostNL - Full parcel status history Canonical statuses provide a stable status layer for automations: - Registered - In transit - Out for delivery - At pickup point - Delivered - Returning - Unknown The original PostNL status text remains available as well, so detailed statuses such as **“Shipment is being sorted”** or **“Courier is on the way”** are not lost. * * * ## Flows PostNL for Homey includes Flow triggers for events such as: - New mail expected - New parcel found - Delivery window became available - Parcel status changed - Parcel delivered - Delivery window changed - New PostNL parcel event - Parcel weight became available - Parcel dimensions became available - Synchronization failure - Login expired Condition cards are also available for checking: - Mail expected - Parcels underway - Delivery window known - PostNL connected - Parcel has weight information - Parcel has dimensions - Current official PostNL parcel status - Current canonical parcel status Condition cards support Homey’s normal and **inverted** state. * * * ## Synchronization PostNL data is refreshed automatically in the background. When PostNL changes information such as the delivery window, parcel status or Track & Trace history, the Homey device, widgets, capabilities and Flow data are updated during synchronization. The app also supports manual refresh through Homey. PostNL does not provide a public consumer API. If one of the non-public interfaces changes, some functionality may temporarily become unavailable until the integration is updated. **[Download in the Homey App Store!](https://homey.app/a/nl.lrvdlinden.postnl/test/)** > **[PostNL | Homey](https://homey.app/en-us/app/nl.lrvdlinden.postnl/PostNL/)** > > See incoming mail and PostNL parcels in Homey, with widgets and Flow cards. * * * Encountering any **issues**? Help us help you by sending a detailed **diagnostic report** via the Homey mobile app. > More → Apps → **PostNL** → Settings wheel in the top-right → Send diagnostic report Please include a short description of the issue so it can be investigated more easily. * * * ## Documentation **[PostNL for Homey Developer Website](https://lrvdlinden.gitbook.io/postnl-for-homey)** * * * ## Changelog > **[PostNL changelog](https://headwayapp.co/postnl-changelog)** > > PostNL changelog * * * 💻 **Apps made by @LRvdLinden** > **[LRvdLinden Apps](https://lrvdlinden.app)** > > iOS- en Homey-apps gemaakt door Léon van der Linden. * * * ## Contribution If you appreciate this app, fuel future development with a [PayPal contribution](https://lrvdlinden.app/donate.html), buy a round with [iDeal](https://lrvdlinden.app/donate.html) or [Bunq.me](https://lrvdlinden.app/donate.html). Your support keeps the magic alive! ✨🚀 * * * --- _[View the full topic](https://community.homey.app/t/app-pro-postnl-for-homey/159674)._