PostNord International offers international shipping solutions for shipments originating in GB, DE, NL, PL, FR, US, CA, BE, CZ.
This guide provides developers with the details needed to build PostNord International shipping capabilities into your ShipStation API workflows.
| Property | Type | Required? |
|---|---|---|
api_key | string | required Provided by PostNord International (via developer portal); used to identify API customer. |
customer_number | string | required Consignor Customer Number for party identification (DK typically 9 digits). |
issuer_code | string | Optional Issuer code associated with the customer number country agreement. |
generate_standard_label_size | boolean | Optional Return longer, standard PostNord label instead of 4x6. |
Pickup/Consignor party details: name, address, postal code, city, country, email, phone, state.
| Field | Description | Type |
|---|---|---|
| api_key | API Key | string |
| customer_number | Customer Number | string |
| generate_standard_label_size | Generate labels in standard PostNord International size | boolean |
| issuer_code | API Key | string |
| api_key | Issuer Code | string |
| pickup_party_name | Pickup Party Name | string |
| pickup_party_address | Pickup Party Address | string |
| pickup_party_postal_code | Pickup Party Postcode | string |
| pickup_party_city | Pickup Party City | string |
| pickup_party_country | Pickup Party Country ISO Alpha-2 Code | string |
| consignor_name | Consignor Name | string |
| consignor_address | Consignor Address | string |
| consignor_postal_code | Consignor Postcode | string |
| consignor_city | Consignor City | string |
| consignor_country | Consignor Country ISO Alpha-2 Code | string |
| consignor_state | Consignor State | string |
| consignor_email | Consignor Email | string |
| consignor_phone | Consignor Phone | string |
You can connect a PostNord International account using the POST method to the /v1/connections/carriers/ endpoint, or via the ShipStation API Dashboard.
For instructions on connecting PostNord International via the ShipStation API dashboard, go to our PostNord International help article.
carrier_name: postnord_international
POST /v1/connections/carriers/:carrier_name
POST /v1/connections/carriers/postnord_international HTTP/1.1
Host: api.shipengine.com
API-Key: __YOUR_API_KEY_HERE__
Content-Type: application/json
{
"nickname": "my PostNord International account nickname",
"accountCode": "123456789",
"username": "your_username",
"password": "pa55word"
}A successful connection will return a response with the carrier_id, which you'll use for any requests for this account going forward.
PostNord International does not send estimated rates to ShipStation API. Your PostNord International account contact can provide you with the details about your contracted rates.
Available PostNord International services are provided below. Please note that carriers may update their available services at any time. To ensure you are always using valid services, you can use the list carrier services endpoint at any time.
PostNord International International shipping services:
| Service | API Code |
|---|---|
| PostNord Home International | postnord_international_my_pack_home_international |
| PostNord Service Point International | postnord_international_my_pack_collect_international |
| PostNord Service Point PUDO International | postnord_international_my_pack_collect_service_point_international |
| Merchandise Mail Level 2 | postnord_international_merchandise_mail_level_2 |
| Merchandise Mail Level 3 | postnord_international_merchandise_mail_level_3 |
| Merchandise Mail Plus Parcel Level 3 | postnord_international_merchandise_mail_plus_parcel_level_3 |
| Service | API Code |
|---|---|
| PostNord Returns International | postnord_international_my_pack_return_intl |
| Merchandise Mail Return | postnord_international_merchandise_mail_return |
The following carrier package types are available for PostNord International services:
| Name | API Code | Package Attributes |
|---|---|---|
| Parcel | postnord_international_pc | International |
PostNord International does not support adding carrier insurance to your shipments.
- Label sizes: 4" x 6"
- Label formats: PDF
By default carrier returns 4x6 label. Other label sizes can be enabled generate_standard_label_size in the carrier settings. If selected then the label will be generated in the standard PostNord size which is longer than 4x6 and may vary depending on the service (set to false as default).
PostNord International supports adding custom label messages. Use label_message_1 to add custom label messages to the label reference fields.
PostNord International supports creating multi-package shipments with all available services.
PostNord International does not support voiding labels with ShipStation API. There is an internal voiding method implemented.
PostNord International does not currently support paperless labels.
PostNord International does not support Shipping Delivery Confirmation.
PostNord International supports advanced options. Supported Advanced Options:
- Limited Quantities of Dangerous Goods - Shipping Limited Quantities of DG is supported but for Denmark and Norway it is require to provide additional details in the products dangerous goods section:
dangerous_goods.id_number
dangerous_goods.technical_name
dangerous_amount.amount
PostNord International does not require manifesting your shipments.
PostNord International does not support scheduling a pickup with ShipStation API.
PostNord International supports shipping to service points. Carrier supports delivery to PUDO points and Service Point finder methods.
ShipStation API's integration with PostNord International supports receiving tracking updates. Review our Track a Package guides for details on tracking with the ShipStation API.
| Issue | Resolution |
|---|---|
| HTTP 403 from PostNord API usually indicates missing/invalid api_key. Reconfirm API key in connection settings and regenerate if needed via Developer Portal. | Carrier Info (801) |
| For UK/US → Nordics on services 17/19/24 ensure issuer_code applies ZDL so customs data is accepted and CN22/CN23 print correctly. | |
| If labels exceed 4×6 layout, either enable standard PostNord size or apply trimming logic per integration guidance. | label trimming note |
| 403 Forbidden (PostNord API) - means Authentication failed; api_key missing or invalid. | Verify carrier connection credentials; generate/replace API key in PostNord Developer Portal; retry request |
See the Disconnect section in our Delete a Carrier page for the process of deleting or disconnecting a carrier from ShipStation API.
NOTE:
If you disconnect a carrier account and reconnect it, the account will have a new
carrier_idin ShipStation API.