Add PostNL services to your webshop
Connect quickly and easily using our PostNL API's
Always the right address
Automatically add addresses during checkout with address validation.
Easily add delivery options to your checkout
Choose evening delivery, delivery to a PostNL point and choice of delivery date.
Prepare your parcels
Submit parcel orders, print shipping labels and send automatic track & trace emails.
Get started
- 1
Find your ideal API solution
This portal helps you through select the API's you need and eventually guides you to every step of the development journey. - 2
Login to MijnPostNL or request API key
Sign up to access our API's and start creating amazing experiences. Already a PostNL Parcels customer? It is highly recommended to request and manage the API key via MijnPostNL. In this way, your customer data is directly linked to your personal API credentials. - 3
Testing the API's
You can test the API's without writing any code. Run the API Collections directly in the Postman application to test with sample requests. - 4
Read the documentation
Get familiar with our API documentation. The detailed essential information common to all of our services. You need to be aware of these conventions before integrating any of our API's. - 5
Go to production
Integrate the API's into your webshop, e-commerce platform and/or backend application(s). Our Technical Support team will approve the move to production and will provide you with credentials.
More conversion, less returns?
Remi Romme - Megekk0
‘We use the API to offer more delivery options for free. The reviews and higher conversion rate clearly show that our customers really value this!’
Just de Klein – Goossens Wonen
‘The address validation lets us not only improve our own delivery process, but also gives customers extra certainty.’
Martin Bless – America Today
‘The API is essential for us as a webshop. There are a lot less wrong addresses in our system, so fewer mistakes to correct.’
Need help?
See our Frequently Asked Questions
PostNL customers can request an API key through the business portal MijnPostNL (mijn.postnl.nl). In the portal, please go to My Account > Manage API's > select the correct customer number > follow the instructions to request the API key. After requesting the key, please wait a moment and refresh the page. If you are building the API(s) yourself (and not using a plugin solution) you will likely receive a sandbox key first. After succesful testing and confirmation from PostNL's Digitale Klant Support team you will be provided with a production key. Once generated, API keys are visible in the portal under My Account > Manage API's.
If you are not a PostNL customer yet, there is an option to receive test credentials including a sandbox (test) API key via: https://developer.postnl.nl/request-api-key/. Please note that production keys are only provided to customers.
API keys have multiple dependencies that can result in errors like: "The user is not authorized for this operation based on …". Please make sure you are using the correct credentials and endpoint with the correct API key. For example, your production API key is only able to make calls to the API production endpoint. The keys are also often linked to your specific customer credentials such as customer number and customer code - please make sure to use the credentials PostNL has provided for implementation.
We are introducing the next generation of APIs to ensure an improved, more uniform and future-proof integration for your webshop. These new APIs are aimed at improving performance, increasing security and creating more uniformity. We are modernising the technology behind the APIs, making them suitable for our new data models and introducing API Life Cycle Management. This enables us to gather as many changes as possible in a new version so that you can switch optimally in one go.
In 2025, we started rolling out the renewed APIs in phases. From January 2026, it will be possible to start using the new APIs. The plug-ins will follow shortly after. You will be notified in time when it’s necessary to switch.