# Set up NZ Couriers
URL: https://support.starshipit.com/articles/4404567208079-set-up-nz-couriers
Canonical: https://support.starshipit.com/articles/4404567208079-set-up-nz-couriers
Markdown: https://support.starshipit.com/articles/4404567208079-set-up-nz-couriers.md
Updated: 2026-11-01

> For the complete documentation index, see [llms.txt](https://support.starshipit.com/llms.txt).

> Step-by-step guide to setting up NZ Couriers.

Connect NZ Couriers to Starshipit to create New Zealand domestic labels, show rates, manage tracking, and choose delivery defaults.

## Before you begin

To integrate with NZ Couriers you'll need to have your:

* NZ Couriers Account Number
* Client ID and Client Secret
* Any product codes and satchel codes available on your NZ Couriers account

If you don't have these credentials please contact your NZ Couriers account manager or [contact NZ Couriers via email or phone](https://www.nzcouriers.co.nz/contact.html).

## Set up NZ Couriers in Starshipit

To enable NZ Couriers as a courier in New Zealand, go to:

1. Go to **Settings** > **Couriers** > click **Add a new courier**.
2. Select **New Zealand** as the shipping-from country, then select **NZ Couriers**.
3. Tick **Enable NZ Couriers**.
4. Enter your **Account number**, **Client ID**, and **Client secret**.
5. Click **Save**.

Once you've entered and saved these details click **Test to ensure it works** to confirm that your integration is correctly set up.

## Available product codes with NZ Couriers

NZ Couriers via Starshipit can be setup with three different product code types:

**Overnight Delivery**

Overnight is the standard service offering for NZ Couriers. It can be used anywhere in New Zealand as long as NZ Couriers offers pickups and deliveries in that area.

**Two Day Delivery**

Two Day delivery is offered as an economy service for inter-island shipments. This means in Starshipit you will only see pricing for Two Day, if you have pricing loaded on your NZ Couriers account, and the shipment is inter-island (e.g. sending from Auckland to Christchurch)

**Express Pack / Satchels**

NZ Couriers offer pre-paid Express Packs (Satchels) that can be sent locally, regionally or nationally at a flat price unless you are sending to a Residential or Rural address or opt for a Saturday delivery.

Express packs used for Saturday, Residential or Rural services require an extra ticket relevant to that service.

You can learn more about the pricing of express packs [here](https://help.nzcouriers.co.nz/pricing-ticketing/price-of-express-packs).

:::note
For more information on service offerings, please visit the NZ Couriers website.
:::

## Configure NZ Couriers settings

| Setting | What it does |
| --- | --- |
| Enable NZ Couriers | Makes NZ Couriers available for shipment creation. |
| Account number, Client ID, and Client secret | Authenticate your Freightways account. |
| Product codes | Add the standard and satchel service codes available on your account and choose defaults where required. |
| Validate satchel size and weight | Optionally hides supported satchel rate options when a package exceeds their published size or weight limit. |
| Format for outbound labels and Format for return labels | Choose the paper size and layout for delivery and return labels. Select formats that work with your printer. |
| Signature Required | Applies signature as a default delivery option. |
| Use customer reference on labels | Uses the supplied customer reference, limited to 20 characters, with the existing order-number fallback. See [Show the customer reference on labels](#show-the-customer-reference-on-labels). |
| Saturday Delivery | Applies Saturday delivery as a default option where available. |
| Send Notifications and Notification Type | Sends tracking updates to receivers and lets you choose how they receive them. |
| Mixed Packaging | Allows mixed packaging where supported. |
| Dangerous Goods | Add up to three DG entries with commodity number, shipping name, class, packing group, cargo-aircraft and road-transport flags, radioactive/DG-LQ/marine-pollutant flags, and flashpoint. |
| Tools > Validate account | Tests the saved account credentials. |
| Tools > Cancel a shipment | Enter a tracking number to submit a cancellation. |

## Add product codes

To add the product codes you'd like to use for NZ Couriers follow these steps:

1. Scroll to **Add product codes**.
2. Select **Add a new product code**, or select **Add default product codes** to load Starshipit's defaults.
3. Enter the **Code** and **Name** supplied by NZ Couriers. Use the satchel reference list when adding prepaid Express Pack services.
4. If the product code should be your default, tick **Default**.
5. Click **Save**.

## Choose label formats

In **Label formats**, select the default **Format for outbound labels** and **Format for return labels**, then click **Save**. The available formats come from the courier settings and can include thermal and A4 options.

## Show the customer reference on labels

1. In UI 2.0, go to **Settings > Couriers > NZ Couriers**.
2. Open **Advanced** and enable **Use customer reference on labels**.
3. Select **Save**, then reopen the settings to confirm the option remains enabled.
4. Check the customer reference on the order before creating its next label. Confirm the reference appears on that label.

This option is off by default. When enabled, labels use up to the first 20 characters of the supplied customer reference. If no customer reference is supplied, the existing order-number or sequence fallback is used. If the reference is missing or shortened, check the order's customer-reference value and the 20-character limit.

## Configure advanced settings

If required you can also update your Advanced Settings for NZ Couriers.

The available Advanced Settings are:

* **Signature Required** defaults all orders to signature-required delivery.
* **Saturday Delivery** defaults all orders to Saturday delivery.
* **Send Notifications** enables notifications by default. When dispatching an order, confirm that its **Send Notifications** option is selected.
* **Notification Type** selects the notification type when **Send Notifications** is enabled. Freightways may charge for SMS notifications.
* **Mixed Packaging** allows mixed packaging where supported by NZ Couriers.
* **Validate satchel size and weight** hides known Express Pack rates when any package exceeds the applicable published size or weight limit. The setting is off by default. Satchel codes without a confirmed limit remain available, and this check does not validate label creation.

Click **Save** after changing advanced settings.

## Add dangerous-goods entries

If your account is approved to ship dangerous goods, open the **Dangerous Goods** tab and select **Add new**. NZ Couriers supports up to three entries. Complete the fields below for each entry, using the product's safety data sheet:

| Field | Purpose |
| --- | --- |
| **Default** | Uses the entry when an order is marked as dangerous goods without a specific entry. |
| **Commodity Number** | Identifies the dangerous good. |
| **Proper Shipping Name** | The transport name for the material. |
| **Class**, **Packing Group** | Records the regulated classification. |
| **Cargo Aircraft**, **Road Transport**, **Radioactive**, **Dangerous Goods In Limited Quantities**, **Marine Pollutant** | Records the applicable transport flags. |
| **Flashpoint** | Records the flashpoint when applicable. |

Save the dangerous-goods entries before applying them to orders or rules.

## Validate or cancel a shipment

Open the **Tools** tab to select **Test to ensure it works** and validate the saved account credentials. To cancel a shipment, enter its **Tracking number** and select **Cancel**.

## Verify the connection

Create a test domestic shipment and confirm a rate and label are returned. If you use dangerous goods, verify that the correct default entry is applied and that the declaration information is present.