Spring Global, part of PostNL, offers cross-border international shipping services and support for dangerous goods shipping when shipping from Great Britain and most EU countries.
This guide provides developers with the details needed to build Spring Global shipping capabilities into your ShipStation V2 API workflows.
| Property | Type | Required? | Description |
|---|---|---|---|
nickname | string | required | Used to identify your account in ShipStation V2 API |
api_key | string | required | Your Spring Global account API key |
You can connect a Spring Global account using the POST method to the /v2/connections/carriers/ endpoint, or via the ShipStation dashboard.
Log in to your ShipStation account and navigate to the Carriers section to connect your Spring Global account using your credentials.
carrier_code: spring_global
POST /v2/connections/carriers/:carrier_code
- Productionhttps://api.shipstation.com/v2/connections/carriers/{carrier_name}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
- connect_access_worldwide_request_body
- connect_amazon_buy_shipping_request_body
- connect_amazon_shipping_uk
- connect_apc_request_body
- connect_asendia_request_body
- connect_australia_post_request_body
- connect_canada_post_request_body
- connect_dhl_ecommerce_request_body
- connect_dhl_express_request_body
- connect_dhl_express_au_request_body
- connect_dhl_express_ca_request_body
- connect_dhl_express_uk_request_body
- connect_dpd_request_body
- connect_endicia_request_body
- connect_fedex_request_body
- connect_fedex_uk_request_body
- connect_firstmile_request_body
- connect_imex_request_body
- connect_lasership_request_body
- connect_newgistics_request_body
- connect_ontrac_request_body
- connect_purolator_request_body
- connect_royal_mail_request_body
- connect_rr_donnelley_request_body
- connect_seko_request_body
- connect_sendle_request_body
- connect_stamps_request_body
- connect_ups_request_body
curl -i -X POST \
https://api.shipstation.com/v2/connections/carriers/dhl_express \
-H 'Content-Type: application/json' \
-H 'api-key: YOUR_API_KEY_HERE' \
-d '{
"nickname": "Stamps.com",
"username": "your_username",
"password": "your_password"
}'A successful connection will return a response with the carrier_id, which you'll use for any requests for this account going forward.
Spring Global does not send estimated rates to ShipStation V2 API. Your Spring Global account contact can provide you with the details about your contracted rates.
Available Spring Global 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 (ShipEngine guide) endpoint at any time.
| Service | API Code | Ship From Countries | Ship To Countries |
|---|---|---|---|
| Untracked | spring_global_untr | UK, FR, DE, ES, NL | Worldwide |
| Tracked | spring_global_trck | UK, FR, DE, ES, NL | Worldwide |
| Signature | spring_global_sign | FR, DE, ES, NL | Worldwide |
| Spring Collect | spring_global_cllct | UK & EU | Worldwide |
Spring Global supports the following return services:
| Service | API Code |
|---|---|
| BACK | spring_global_back |
Spring Global's BACK service is available across Europe but is unavailable in the UK.
The following carrier package types (ShipEngine guide) are available for Spring Global services:
| Name | API Code | Package Attributes |
|---|---|---|
| Spring Global Package | spring_global_package | International |
Adding carrier insurance is not supported for this carrier.
- Label sizes: 4" x 6"
- Label formats: PDF, PNG, ZPL
Spring Global does not currently support label messages (ShipEngine guide).
Spring Global does not support multi-package shipments (ShipEngine guide).
You can void Spring Global labels via ShipStation V2 API.
See our Void a Label page (ShipEngine guide) for details about voiding labels with ShipStation V2 API.
Spring Global does not support paperless Labels (ShipEngine guide).
Customs declarations for Spring Global shipments are submitted electronically when you send your label request.
NOTE: Action Required: New Zealand Border Levy Changes
Effective April 1, 2026, a new NZD $2.21 (+ GST) levy applies to low-value air freight consignments entering New Zealand. This levy is charged per consignment, not per item.
See the Shipping to New Zealand: Low Value Goods (LVG) Levy section in International Shipments (ShipEngine guide) for full details.
| Confirmation Type | API Code | Description |
|---|---|---|
| No confirmation required | none | Default value. Only the "Signature" service allows another confirmation type. |
| Personal Delivery | signature | Available only to the "Signature" service class. |
See our Delivery Confirmation page (ShipEngine guide) for more details about using the confirmation property.
Spring Global supports certain advanced options, which you can add to the shipment object when creating a shipment or label.
| Option | Type | Default Value | Description |
|---|---|---|---|
delivered_duty_paid | string | null | Bills any applicable duties and taxes to the sender of the shipment (DDP). |
To ensure you always have the most up-to-date information about a carrier's advanced options, use the list carrier options call (ShipEngine guide).
Spring Global does not support creating manifests (ShipEngine guide) with ShipStation V2 API.
Spring Global does not support scheduling a pickup (ShipEngine guide) using ShipStation V2 API.
The Spring Collect service allows shipping to a service point.
See our Intro to Service Points (ShipEngine guide) for more details about how to use service points with ShipStation V2 API.
ShipStation V2 API's integration with Spring Global supports receiving tracking updates for the Tracked, Signature, and Spring Collect services. Review our Track a Package guides (ShipEngine guide) for details on tracking with the ShipStation V2 API.
Please note the "Untracked" service class does not support tracking.
See the Disconnect section in our Delete a Carrier page (ShipEngine guide) for the process of deleting or disconnecting a carrier from ShipStation V2 API.
NOTE:
If you disconnect a carrier account and reconnect it, the account will have a new
carrier_idin ShipStation V2 API.