Skip to content

PostNord International

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.

Requirements

The following fields are required to establish a connection with PostNord International:

PropertyTypeRequired?Description
api_keystringrequiredAPI Key provided by PostNord International (via developer portal); used to identify API customer.
customer_numberstringrequiredCustomer Number for party identification (DK typically 9 digits).
application_versionstringrequiredApplication Version: This 3-letter code is a Customer ID provided by the carrier.

Connection Requirements

Optional: To successfully integrate your account, provide the specific pickup, consignor, and authentication credentials detailed below.

FieldDescriptionTypeRequired?
issuer_codeIssuer code associated with the customer number country agreement.stringoptional
generate_standard_label_sizeReturn longer, standard PostNord labels instead of 4x6.booleanoptional
pickup_party_namePickup Party Namestringoptional
pickup_party_addressPickup Party Addressstringoptional
pickup_party_postal_codePickup Party Postcodestringoptional
pickup_party_cityPickup Party Citystringoptional
pickup_party_countryPickup Party Country ISO Alpha-2 Codestringoptional
consignor_nameConsignor Namestringoptional
consignor_addressConsignor Addressstringoptional
consignor_postal_codeConsignor Postcodestringoptional
consignor_cityConsignor Citystringoptional
consignor_countryConsignor Country ISO Alpha-2 Codestringoptional
consignor_stateConsignor Statestringoptional
consignor_emailConsignor Emailstringoptional
consignor_phoneConsignor Phonestringoptional

Connect Account

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.

Connect via Endpoint

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.

Rates

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.

Service Details

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.

International Services

PostNord International shipping services:

ServiceAPI Code
PostNord Home Internationalpostnord_international_my_pack_home_international
PostNord Service Point Internationalpostnord_international_my_pack_collect_international
PostNord Service Point PUDO Internationalpostnord_international_my_pack_collect_service_point_international
Merchandise Mail Level 2postnord_international_merchandise_mail_level_2
Merchandise Mail Level 3postnord_international_merchandise_mail_level_3
Merchandise Mail Plus Parcel Level 3postnord_international_merchandise_mail_plus_parcel_level_3

Return Services

ServiceAPI Code
PostNord Returns Internationalpostnord_international_my_pack_return_intl
Merchandise Mail Returnpostnord_international_merchandise_mail_return

NOTE:

PostNord Returns International requires non-standard address formatting - Unlike typical API shipments, the ship_to address format must be confirmed directly with PostNord, as it varies by destination country and does not follow standard address conventions.

For example, returns to Sweden require "U-Box: [value]" to be entered in the address_line1 field (where [value] corresponds to the PO Box number assigned by PostNord) instead of a street address. All other address fields (postal code, city, country) must strictly comply with PostNord's specific requirements.

Example for Sweden returns:

{
  "ship_to": {
    "name": "PostNord Returns Center",
    "address_line1": "U-Box: 374",
    "address_line2": "",
    "address_line3": "",
    "city_locality": "Malmö",
    "state_province": "",
    "postal_code": "20226",
    "country_code": "SE"
  }
}

Packages

The following carrier package types are available for PostNord International services:

NameAPI CodePackage Attributes
Parcelpostnord_international_pcInternational

Adding Shipment Insurance

PostNord International does not support adding carrier insurance to your shipments.

Label Support

  • Label sizes: 4" x 6"
  • Label formats: PDF

By default carrier returns 4x6 label. Other label sizes can be enabled by setting 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).

Label Reference Fields

PostNord International supports adding custom label messages. Use label_message_1 to add custom label messages to the label reference fields.

Multi-Package Labels

PostNord International supports creating multi-package shipments with all available services.

Voiding Labels

PostNord International does not support voiding labels with ShipStation API. There is an internal voiding method implemented.

Paperless Labels

PostNord International does not currently support paperless labels.

Delivery Confirmation

PostNord International does not support Shipping Delivery Confirmation.

Advanced Options

PostNord International supports advanced options. Supported Advanced Options:

  • Limited Quantities of Dangerous Goods (DG) - Shipping Limited Quantities of DG is supported but for Denmark and Norway it is required to provide additional details in the products dangerous goods section:

dangerous_goods.id_number

dangerous_goods.technical_name

dangerous_amount.amount

Manifests

PostNord International does not require manifesting your shipments.

Scheduling Pickups

PostNord International does not support scheduling a pickup with ShipStation API.

Service Points (PUDO)

PostNord International supports shipping to service points. Carrier supports delivery to PUDO points and Service Point finder methods.

Tracking

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.

Troubleshooting Tips

IssueResolution
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.Enable generate_standard_label_size in carrier settings to use PostNord's standard label size, or adjust label handling to accommodate larger formats.
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

Disconnecting Your PostNord International Account

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_id in ShipStation API.