# 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-09-03 > 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. | | 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. | | 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. ## 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. 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.