# Set up Castle Parcels
URL: https://support.starshipit.com/articles/4406125209487-set-up-castle-parcels
Canonical: https://support.starshipit.com/articles/4406125209487-set-up-castle-parcels
Markdown: https://support.starshipit.com/articles/4406125209487-set-up-castle-parcels.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 Castle Parcels.

Connect Castle Parcels to create domestic New Zealand shipments in Starshipit, choose product codes and set label and delivery defaults.

## Before you begin

To integrate with Castle Parcels you'll need to have your Castle Parcels Account Number, Client ID and Client Secret available.

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

## Enable Castle Parcels in Starshipit

To enable Castle Parcels as a courier in New Zealand:

1. Go to **Settings > Couriers > Add a new courier**.
2. Click Castle Parcels from the list of couriers.
3. Tick **Enable Castle Parcels**.
4. Enter your Castle Parcels **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 Castle Parcels

Castle Parcels via Starshipit can be set up with two different product code types:

**Overnight Delivery**

Overnight is the standard service offering for Castle Parcels. 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 Castle Parcels account, and the shipment is inter-island (e.g. sending from Auckland to Christchurch)

## Add your product codes

Finally, add the product codes you'd like to use for Castle Parcels by going to:

1. **Add product codes** section > Click **Add a new product code**.
2. Enter the **Code** and **Name** for the product code.
3. If the product code should be your default, tick the **Default** checkbox.
4. Click **Save**.

## Show the customer reference on labels

1. In UI 2.0, go to **Settings > Couriers > Castle Parcels**.
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.

## Advanced settings

If required you can also update your Advanced Settings for Castle Parcels.

The available Advanced Settings are:

* **Signature Required:** Select this option to default 'Signature Required' on all orders.
* **Saturday Delivery:** Select this option to default 'Saturday Delivery' on all orders.
* **Send Notifications:** To automatically send notifications for every order, enable the "Send Notifications" option. When dispatching orders, ensure the "Send Notifications" checkbox is selected. The default state of this option is determined by your settings preference.
* **Notifications Type:** When send notifications is ticked, what type of notifications should be sent? Note that Freightways may incur additional charges for SMS notifications.
* **Validate satchel size and weight:** Turn this on to hide known satchel rate options when any package exceeds the applicable published size or weight limit. It is off by default. Codes without a confirmed limit remain available, and this check does not validate label creation.

## Configure Castle Parcels settings

In addition to the credentials and defaults above, Castle Parcels provides:

| Setting | What it controls |
| --- | --- |
| **Format for outbound labels** | Sets the paper size and layout Starshipit uses for labels on customer deliveries. Choose the option that matches your printer. |
| **Format for return labels** | Sets the paper size and layout for labels included with return shipments. Choose the option that matches your printer. |
| **Signature Required** | Adds signature-required delivery to eligible shipments by default. |
| **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** | Requests Saturday delivery by default when the selected service supports it. |
| **Send Notifications** | Requests Castle Parcels tracking notifications for shipments created in Starshipit. |
| **Notification Type** | Sets whether the receiver is notified by email or SMS. Freightways may charge for SMS notifications. |
| **Mixed Packaging** | Lets one shipment include different package types when Castle Parcels supports it. |
| **Validate Receiver Address** | Checks the receiver's delivery address before it is sent for booking, so you can correct problems before a label is created. |

These options are saved with the Castle Parcels courier settings. Check the label and notification result on a test shipment before enabling defaults for all orders.
