PostNL
Direct PostNL integration for shops with their own PostNL contract. Create shipping labels, generate barcodes, confirm shipments, and track parcels. Supports domestic (NL/BE), EU, and worldwide shipping.
Endpoints (7)
Create a shipment with barcode + label in one call. Uses the PostNL Shipping API (all-in-one). The label PDF is automatically stored as a PAPI asset. Optionally confirms the shipment immediately.
No input parameters required.
Confirm a shipment to PostNL (if not confirmed during creation). Required before dropping off the parcel.
No input parameters required.
Get tracking status for a shipment. Returns current status, timestamps, and tracking events.
No input parameters required.
Download the shipping label PDF. Returns the PAPI asset CDN URL.
No input parameters required.
Find nearby PostNL pickup points (pakketpunten). Use in checkout for customers choosing pickup delivery.
No input parameters required.
Get available delivery dates and timeframes for a destination. Use in checkout to let customers choose standard, evening, or morning delivery.
No input parameters required.
Create a return label (single label, not label-in-the-box). Generates a label the customer can print and attach to their return parcel. Requires PostNL Antwoordnummer.
No input parameters required.
MCP Tool Names
When using this integration through an AI assistant (Claude, ChatGPT, Cursor, etc.), the endpoints are available as MCP tools:
| Endpoint | MCP Tool Name |
|---|---|
| create-shipment | postnl_create_shipment |
| confirm-shipment | postnl_confirm_shipment |
| track-shipment | postnl_track_shipment |
| get-label | postnl_get_label |
| get-pickup-locations | postnl_get_pickup_locations |
| get-delivery-options | postnl_get_delivery_options |
| create-return-label | postnl_create_return_label |