[APP][Pro] PostNL for Homey

PostNL for Homey

View expected mail items and PostNL parcels directly in Homey. The app uses PostNL’s personal, non-public interface and may therefore require changes if PostNL updates its mobile app or sign-in procedure. With two convenient widgets, you can see at a glance what mail and parcels are on their way.

Linking your PostNL account

  1. Download the PostNL Homey Login Helper here, then extract the ZIP file. The helper is a Google Chrome extension.

  2. Open chrome://extensions, enable Developer mode, and select Load unpacked.

  3. In Homey, go to Add Device → PostNL → My PostNL.

  4. Copy the URL shown below the Open PostNL button, paste it into a new browser window, and sign in to your PostNL account.

  5. The helper automatically captures the callback. Return to the PostNL App Settings, click Open PostNL, paste the callback into the input field that appears, and complete the sign-in process.

  6. You can then add the My PostNL device.

The Homey app and browser helper do not store your PostNL password. Never share callbacks or tokens with anyone.

The app automatically checks the current PostNL iOS app version every day, retrieves new data every five minutes, and performs additional checks around midnight for new My Post items. Mail item information and images are stored locally in Homey for a maximum of 21 days.

PostNL does not provide a public consumer API. If a non-public My Post endpoint changes, the My PostNL device will remain available and parcel tracking will continue to work. The device status and widget will then indicate that My Post is temporarily unavailable, instead of making the entire device unavailable.

Important: Use the same email address of your account are registered at PostNL app or website.

Download in the Homey App Store!


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



:laptop: Apps made by @LRvdLinden


See for more apps link below 👇🏻 or just open the pull down.


Contribution

If you appreciate this app, fuel future development with a PayPal contribution, buy a round with iDeal or Bunq.me. Your support keeps the magic alive! :sparkles::rocket:


Great that we now have an app for PostNL! :clap: 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.

Edit: The issue only occurs in the iOS app (PNG), in the web browser (SVG) it looks fine.

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?

I would assume that clicking on "Open PostNL’ It should jump to the PostNL website, but instead it goes to the next screen:

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?

Will fix the icon soon.

Right click the button open postNL and open it in a separate tab. That worked for me

Great @Stef_Jacops That did it for me! Thank you for your help :blush:

I will fix the button that it will open directly the url under it.

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.

:package: v0.2.1 (beta)

New test version!


Fix

:artist_palette: Driver icon: Fix de outline driver icon for iOS.

Improvement

:wrench: 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.

:glowing_star: Enjoy the latest version of PostNL App with small improvements under the hood, ensuring a smoother experience for all users! :rocket:


Download in the Homey App Store!


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



:laptop: Apps made by @LRvdLinden


See for more apps link below 👇🏻 or just open the pull down.


Contribution

If you appreciate this app, fuel future development with a PayPal contribution, buy a round with iDeal or Bunq.me. Your support keeps the magic alive! :sparkles::rocket:


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

:package: v1.0.1

New test version!


New

  • First release

Improvement

:wrench: 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.

:glowing_star: Enjoy the latest version of PostNL App with small improvements under the hood, ensuring a smoother experience for all users! :rocket:


Download in the Homey App Store!


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



:laptop: Apps made by @LRvdLinden


See for more apps link below 👇🏻 or just open the pull down.


Contribution

If you appreciate this app, fuel future development with a PayPal contribution, buy a round with iDeal or Bunq.me. Your support keeps the magic alive! :sparkles::rocket:


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

Can you send me an report and screenshot of the flow?

Report:

731a2a6e-b7cd-4c76-ae21-349a7034e1a2

Hope this helps

Cheers
Eric

:package: v1.0.2

New test version!


Fix

:wrench: 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

:wrench: 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.

:glowing_star: Enjoy the latest version of PostNL App with small improvements under the hood, ensuring a smoother experience for all users! :rocket:


Download in the Homey App Store!


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



:laptop: Apps made by @LRvdLinden


See for more apps link below 👇🏻 or just open the pull down.


Contribution

If you appreciate this app, fuel future development with a PayPal contribution, buy a round with iDeal or Bunq.me. Your support keeps the magic alive! :sparkles::rocket:


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.

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

Great app would be nice if you can add multiple accounts for household

Good feedback. I will move the app settings to the device in the next update.

:package: v1.1.0

New live version!


New

:bust_in_silhouette: 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.

:locked_with_key: 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.

:counterclockwise_arrows_button: Per-device reconnect: If credentials expire, you can reconnect only the affected PostNL device without affecting your other accounts.

:bell: Timeline notification for expired credentials: Homey now sends a localized Timeline notification when a PostNL account needs to be reconnected.

:package: 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

:puzzle_piece: Flow cards improved: Trigger cards and their tokens are now fully device-dependent. This improves reliability when using multiple PostNL accounts.

:desktop_computer: Widgets updated for multiple accounts: My Post and My Package now work with the PostNL device selected in the widget settings.

:warning: 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.

:locked_with_key: Safer authentication diagnostics: Authentication logs never expose access tokens, refresh tokens, authorization codes or callback URLs. Diagnostics only indicate whether credentials are present.

:link: Improved login screen: The pairing screen now uses proper Homey controls with separate Copy URL and Open PostNL buttons.

:label: vImproved Homey Store metadata**: Added relevant PostNL, mail, parcel, delivery and tracking tags.

:wrench: 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.

:glowing_star: Enjoy the latest version of PostNL App with small improvements under the hood, ensuring a smoother experience for all users! :rocket:


Download in the Homey App Store!


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



:laptop: Apps made by @LRvdLinden


See for more apps link below 👇🏻 or just open the pull down.


Contribution

If you appreciate this app, fuel future development with a PayPal contribution, buy a round with iDeal or Bunq.me. Your support keeps the magic alive! :sparkles::rocket: