# \[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:** 20\ **Page:** 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! ✨🚀 * * * ---
**Author:** ![Graaf](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/graaf/32/159113_2.png) [@Graaf](https://community.homey.app/u/Graaf)\ **Post date:** [September 16, 2026, 6:09pm UTC](https://community.homey.app/t/app-pro-postnl-for-homey/159674/2 "2026-09-16T18:09:06Z")
Great that we now have an app for PostNL! 👏 I’ve got it running on my Homey and added two widgets to my dashboard. The only thing I’ve noticed so far is that something’s off with the driver icon. ![IMG_0583](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/e/f/ef16fbbae74f443fb70e2173ffab34775fa5c64b.jpeg) Edit: The issue only occurs in the iOS app (PNG), in the web browser (SVG) it looks fine. ---
**Author:** ![Borssie](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/borssie/32/120230_2.png) [@Borssie](https://community.homey.app/u/Borssie)\ **Post date:** [September 16, 2026, 7:24pm UTC](https://community.homey.app/t/app-pro-postnl-for-homey/159674/3 "2026-09-16T19:24:03Z")
Goodevening, I installed the extention, followed the instructions, though after login onto the PostNL website I don’t get to see the copy callback option, as no login was registered. What am I doing wrong? ![Screenshot 2026-09-16 21.26.18](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/5/4/54509f22b8512cadf8e69cfc631134616039a729.png) I would assume that clicking on "Open PostNL’ It should jump to the PostNL website, but instead it goes to the next screen: ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/b/c/bc336e71f276f735b5732a8b18bdb4bb8adcd85b.png) Manually loading the PostNL login screen doesn’t let me capture the login callback… Diag report id: 257db529-a4eb-494c-986a-ed8e9d55ff96 @Graaf How did you manage to succesfully login? ---
**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, 7:25pm UTC](https://community.homey.app/t/app-pro-postnl-for-homey/159674/4 "2026-09-16T19:25:11Z")
Will fix the icon soon. ---
**Author:** ![Stef\_Jacops](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/stef_jacops/32/101012_2.png) [@Stef\_Jacops](https://community.homey.app/u/Stef_Jacops)\ **Post date:** [September 16, 2026, 7:33pm UTC](https://community.homey.app/t/app-pro-postnl-for-homey/159674/5 "2026-09-16T19:33:28Z")
Right click the button open postNL and open it in a separate tab. That worked for me ---
**Author:** ![Borssie](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/borssie/32/120230_2.png) [@Borssie](https://community.homey.app/u/Borssie)\ **Post date:** [September 16, 2026, 7:43pm UTC](https://community.homey.app/t/app-pro-postnl-for-homey/159674/6 "2026-09-16T19:43:16Z")
Great @Stef_Jacops That did it for me! Thank you for your help 😊 ---
**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, 7:51pm UTC](https://community.homey.app/t/app-pro-postnl-for-homey/159674/7 "2026-09-16T19:51:12Z")
I will fix the button that it will open directly the url under it. ---
**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, 9:29pm UTC](https://community.homey.app/t/app-pro-postnl-for-homey/159674/8 "2026-09-16T21:29:40Z")
If anyone has mail items listed in their PostNL iOS or Android app, could you please send me a screenshot of the mail widget via DM? This is to verify that the widget is working. ---
**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 17, 2026, 5:35am UTC](https://community.homey.app/t/app-pro-postnl-for-homey/159674/9 "2026-09-17T05:35:37Z")
## 📦 **v0.2.1 (beta)** ## **New _test_ version!** * * * ### Fix 🎨 **Driver icon** : Fix de outline driver icon for iOS. ### Improvement 🔧 Under-the-Hood Enhancements: In this version of **PostNL** , we’ve made some minor improvements to enhance overall performance and logging for user experience. We’re continuously working behind the scenes to fine-tune the app for the best possible user experience. Your feedback is invaluable! If you encounter any issues or have suggestions, feel free to reach out through our support channels. 🌟 Enjoy the latest version of **PostNL** App with small improvements under the hood, ensuring a smoother experience for all users! 🚀 * * * **[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/test/)** > > See incoming mail and PostNL parcels in Homey, with widgets and Flow cards. * * * Encountering any **issues**? Help us help you by sending a detailed **report** via the mobile Homey app. > More - apps - **PostNL** - settings wheel top right - send diagnostic report (include your email and issues in the input field for better assistance) * * * ## Changelog > **[PostNL changelog](https://headwayapp.co/postnl-changelog)** > > PostNL changelog * * * * * * 💻 **Apps made by @LRvdLinden** * * * See for more apps link below 👇🏻 or just open the pull down. > [@Apps made by @LRvdLinden](https://community.homey.app/t/apps-made-by-lrvdlinden/85452/1): > > Click to expand * * * ## 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! ✨🚀 * * * ---
**Author:** ![friethoe](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/friethoe/32/9647_2.png) [@friethoe](https://community.homey.app/u/friethoe)\ **Post date:** [September 17, 2026, 12:55pm UTC](https://community.homey.app/t/app-pro-postnl-for-homey/159674/10 "2026-09-17T12:55:47Z")
Wow!!! Dit stond al zooooo lang op mijn verlanglijstje! Wat geweldig dat dit nu via Homey is te volgen! Super bedankt!! Het werkt prima!! Dank dank dank!! Groet, Eric ---
**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 18, 2026, 6:49am UTC](https://community.homey.app/t/app-pro-postnl-for-homey/159674/11 "2026-09-18T06:49:11Z")
## 📦 **v1.0.1** ## **New _test_ version!** * * * ### New - First release ### Improvement 🔧 Under-the-Hood Enhancements: In this version of **PostNL** , we’ve made some minor improvements to enhance overall performance and logging for user experience. We’re continuously working behind the scenes to fine-tune the app for the best possible user experience. Your feedback is invaluable! If you encounter any issues or have suggestions, feel free to reach out through our support channels. 🌟 Enjoy the latest version of **PostNL** App with small improvements under the hood, ensuring a smoother experience for all users! 🚀 * * * **[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/test/)** > > See incoming mail and PostNL parcels in Homey, with widgets and Flow cards. * * * Encountering any **issues**? Help us help you by sending a detailed **report** via the mobile Homey app. > More - apps - **PostNL** - settings wheel top right - send diagnostic report (include your email and issues in the input field for better assistance) * * * ## Changelog > **[PostNL changelog](https://headwayapp.co/postnl-changelog)** > > PostNL changelog * * * * * * 💻 **Apps made by @LRvdLinden** * * * See for more apps link below 👇🏻 or just open the pull down. > [@Apps made by @LRvdLinden](https://community.homey.app/t/apps-made-by-lrvdlinden/85452/1): > > Click to expand * * * ## 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! ✨🚀 * * * ---
**Author:** ![friethoe](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/friethoe/32/9647_2.png) [@friethoe](https://community.homey.app/u/friethoe)\ **Post date:** [September 18, 2026, 7:25pm UTC](https://community.homey.app/t/app-pro-postnl-for-homey/159674/12 "2026-09-18T19:25:06Z")
Hi Léon, I created flows to add item to timeline in case of new items. In widget a new parcel is shown, but the triggercard did not add a text to the timeline. Also , the app was not updated by homey. I had to install from this topic thanks for your help Cheers Eric ---
**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 18, 2026, 9:06pm UTC](https://community.homey.app/t/app-pro-postnl-for-homey/159674/13 "2026-09-18T21:06:34Z")
Can you send me an report and screenshot of the flow? ---
**Author:** ![friethoe](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/friethoe/32/9647_2.png) [@friethoe](https://community.homey.app/u/friethoe)\ **Post date:** [September 18, 2026, 9:39pm UTC](https://community.homey.app/t/app-pro-postnl-for-homey/159674/14 "2026-09-18T21:39:24Z")
Report: 731a2a6e-b7cd-4c76-ae21-349a7034e1a2 ![image](https://us1.discourse-cdn.com/flex025/uploads/athom/original/3X/7/e/7ef4b27642dabf47e99b909de2bf5fc81f09d261.png) Hope this helps Cheers Eric ---
**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 19, 2026, 5:39am UTC](https://community.homey.app/t/app-pro-postnl-for-homey/159674/15 "2026-09-19T05:39:52Z")
## 📦 **v1.0.2** ## **New _test_ version!** * * * ### Fix 🔧 **Fixed Flow Cards** : We’ve fixed the Flow cards and moved them from the app level to the corresponding device, making them work more reliably and logically within Homey. ### Improvement 🔧 Under-the-Hood Enhancements: In this version of **PostNL** , we’ve made some minor improvements to enhance overall performance and logging for user experience. We’re continuously working behind the scenes to fine-tune the app for the best possible user experience. Your feedback is invaluable! If you encounter any issues or have suggestions, feel free to reach out through our support channels. 🌟 Enjoy the latest version of **PostNL** App with small improvements under the hood, ensuring a smoother experience for all users! 🚀 * * * **[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/test/)** > > See incoming mail and PostNL parcels in Homey, with widgets and Flow cards. * * * Encountering any **issues**? Help us help you by sending a detailed **report** via the mobile Homey app. > More - apps - **PostNL** - settings wheel top right - send diagnostic report (include your email and issues in the input field for better assistance) * * * ## Changelog > **[PostNL changelog](https://headwayapp.co/postnl-changelog)** > > PostNL changelog * * * * * * 💻 **Apps made by @LRvdLinden** * * * See for more apps link below 👇🏻 or just open the pull down. > [@Apps made by @LRvdLinden](https://community.homey.app/t/apps-made-by-lrvdlinden/85452/1): > > Click to expand * * * ## 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! ✨🚀 * * * ---
**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 19, 2026, 5:43am UTC](https://community.homey.app/t/app-pro-postnl-for-homey/159674/16 "2026-09-19T05:43:53Z")
Fixed in version 1.0.2. The fact that the app didn’t automatically update to the latest version is not a bug. Homey updates can sometimes take a while to roll out, or automatic updates may be disabled on your Homey. ---
**Author:** ![friethoe](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/friethoe/32/9647_2.png) [@friethoe](https://community.homey.app/u/friethoe)\ **Post date:** [September 19, 2026, 12:42pm UTC](https://community.homey.app/t/app-pro-postnl-for-homey/159674/17 "2026-09-19T12:42:01Z")
Thanks Léon, it works very nice!! Just received a parcel and your app informed me within minutes about the changed status. Very Nice!! Cheers Eric ---
**Author:** ![Mariomark1541](https://sea1.discourse-cdn.com/flex025/user_avatar/community.homey.app/mariomark1541/32/178160_2.png) [@Mariomark1541](https://community.homey.app/u/Mariomark1541)\ **Post date:** [September 19, 2026, 4:43pm UTC](https://community.homey.app/t/app-pro-postnl-for-homey/159674/18 "2026-09-19T16:43:46Z")
Great app would be nice if you can add multiple accounts for household ---
**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 20, 2026, 7:09am UTC](https://community.homey.app/t/app-pro-postnl-for-homey/159674/19 "2026-09-20T07:09:50Z")
Good feedback. I will move the app settings to the device in the next update. ---
**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 20, 2026, 8:08am UTC](https://community.homey.app/t/app-pro-postnl-for-homey/159674/20 "2026-09-20T08:08:06Z")
## 📦 **v1.1.0** ## **New _live_ version!** * * * ### New 👤 **Multiple PostNL accounts** : PostNL accounts are now linked per device instead of through App Settings. This means you can add multiple My PostNL devices, each connected to its own PostNL account. 🔐 **New device pairing** : Adding a PostNL device now includes the complete login flow. Simply open or copy the PostNL login URL, sign in, copy the callback using the Chrome Login Helper and paste it directly into Homey. 🔄 **Per-device reconnect** : If credentials expire, you can reconnect only the affected PostNL device without affecting your other accounts. 🔔 **Timeline notification for expired credentials** : Homey now sends a localized Timeline notification when a PostNL account needs to be reconnected. 📦 **Everything is now device-specific** : Credentials, mail data, parcel data, capabilities, Flow cards, Flow tokens and widgets are now all linked to the selected PostNL device. ### Improvement 🧩 **Flow cards improved** : Trigger cards and their tokens are now fully device-dependent. This improves reliability when using multiple PostNL accounts. 🖥 **Widgets updated for multiple accounts** : My Post and My Package now work with the PostNL device selected in the widget settings. ⚠ **Important after updating to v1.1.0** : Please edit your existing PostNL widgets once and select your PostNL device again. This reactivates the widget with the new per-device configuration. 🔐 **Safer authentication diagnostics** : Authentication logs never expose access tokens, refresh tokens, authorization codes or callback URLs. Diagnostics only indicate whether credentials are present. 🔗 **Improved login screen** : The pairing screen now uses proper Homey controls with separate Copy URL and Open PostNL buttons. 🏷 vImproved Homey Store metadata\*\*: Added relevant PostNL, mail, parcel, delivery and tracking tags. 🔧 Under-the-Hood Enhancements: In this version of **PostNL** , we’ve made some minor improvements to enhance overall performance and logging for user experience. We’re continuously working behind the scenes to fine-tune the app for the best possible user experience. Your feedback is invaluable! If you encounter any issues or have suggestions, feel free to reach out through our support channels. 🌟 Enjoy the latest version of **PostNL** App with small improvements under the hood, ensuring a smoother experience for all users! 🚀 * * * **[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 **report** via the mobile Homey app. > More - apps - **PostNL** - settings wheel top right - send diagnostic report (include your email and issues in the input field for better assistance) * * * ## Changelog > **[PostNL changelog](https://headwayapp.co/postnl-changelog)** > > PostNL changelog * * * * * * 💻 **Apps made by @LRvdLinden** * * * See for more apps link below 👇🏻 or just open the pull down. > [@Apps made by @LRvdLinden](https://community.homey.app/t/apps-made-by-lrvdlinden/85452/1): > > Click to expand * * * ## 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! ✨🚀 * * * [Next page](https://community.homey.app/t/app-pro-postnl-for-homey/159674.md?page=2)