[APP][Pro] PostNL for Homey

Apps
, , ,
1

xlarge
xlarge1000×700 98.4 KB

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 More → Apps → PostNL → Settings.

  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:

2

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.

IMG_0583
IMG_0583502×471 13.5 KB

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

3

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
Screenshot 2026-09-16 21.26.18479×666 37.5 KB

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

image
image475×746 49.6 KB

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?

4

Will fix the icon soon.

5

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

6

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

7

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

8

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.