PostNL

🔑 BYO Key — Shipping

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.

🔑 Setup Required — Bring Your Own Key This integration requires API credentials. Store them once via setup_integration or the Dashboard Vault — they're encrypted with AES-256-GCM and never exposed.

Required Credentials

postnl_api_key

API Key

Request an API key at mijn.postnl.nl → Instellingen → API instellingen. Calls always go to the live PostNL API, so every label is a real shipment (no sandbox).

postnl_customer_code

Customer Code (Klantcode)

Your 4-letter PostNL customer code (e.g. "DEVC"). Found in your PostNL contract or at mijn.postnl.nl.

postnl_customer_number

Customer Number (Klantnummer)

Your PostNL customer number (8-12 digits). Found in your PostNL contract.

postnl_collection_location

Collection Location (Afhaalpunt)

Your 6-digit PostNL collection location code. Found in your contract or ask your PostNL account manager.

Get your API key at developer.postnl.nl →

Try it with your AI assistant

Once WebsitePublisher is connected to your AI assistant, paste one of these into the chat. Replace the parts in [brackets] with your own details.

ChatGPT Claude Other assistants

@WebsitePublisher create a PostNL label for order [order number] with my own PostNL contract

@WebsitePublisher show the tracking status of PostNL barcode [barcode]

With WebsitePublisher, create a PostNL label for order [order number] with my own PostNL contract

With WebsitePublisher, show the tracking status of PostNL barcode [barcode]

With WebsitePublisher, create a PostNL label for order [order number] with my own PostNL contract

With WebsitePublisher, show the tracking status of PostNL barcode [barcode]

Endpoints (7)

POST create-shipment

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.

POST confirm-shipment

Confirm a shipment to PostNL (if not confirmed during creation). Required before dropping off the parcel.

No input parameters required.

GET track-shipment

Get tracking status for a shipment. Returns current status, timestamps, and tracking events.

No input parameters required.

GET get-label

Download the shipping label PDF. Returns the PAPI asset CDN URL.

No input parameters required.

GET get-pickup-locations

Find nearby PostNL pickup points (pakketpunten). Use in checkout for customers choosing pickup delivery.

No input parameters required.

GET get-delivery-options

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.

POST create-return-label

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`

← Back to all integrations