# Set up NZ Post Domestic URL: https://support.starshipit.com/articles/203806459-set-up-nz-post-domestic Canonical: https://support.starshipit.com/articles/203806459-set-up-nz-post-domestic Markdown: https://support.starshipit.com/articles/203806459-set-up-nz-post-domestic.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 Post domestic. Starshipit's [integration with NZ Post](https://www.starshipit.com/partner/new-zealand-post) lets you generate packing slips and shipping labels, auto-correct addresses, send branded tracking notifications, and use other Starshipit features with your NZ Post account. Starshipit supports NZ Post domestic, international, and express services. These are represented as separate couriers in Starshipit: * NZ Post Domestic * NZ Post International * NZ Post Express ## Setting up NZ Post Domestic ### 1. Gather your NZ Post account details Before you start, have your NZ Post **Account Number** and **Site ID** ready. You can use Starshipit's shared NZ Post connection with these details, so you do not need to request API credentials before setting up NZ Post Domestic. If you have your own NZ Post API credentials and need to keep using them, have both your **API Key** and **API Secret** ready. ### 2. Enter your NZ Post details in Starshipit 1. Go to **Settings** > **Couriers** > **Add New Courier** > **NZ Post Domestic**. 2. Tick **Enable NZ Post Domestic**. 3. Enter your NZ Post Domestic Account Number and Site ID. 4. Under the **Location** dropdown, select your location. 5. Enter your **API Key (optional)** and **API Secret (optional)** only if you are using your own NZ Post API credentials. Leave both fields blank to use Starshipit's shared NZ Post connection. 6. Click **Save** to confirm your details. 7. Click **Test to ensure it works** to test the integration. 8. Go to the **Advanced** tab to review your other settings. When you use the shared NZ Post connection, **Print domestic labels using API** is enabled automatically. :::important Enter both the **API Key** and **API Secret**, or leave both blank. Entering only one credential causes a validation error. Your NZ Post **Account Number** and **Site ID** are always required. ::: ### 3. Set your default products Once Starshipit has confirmed NZ Post Domestic is available on your account, you should check that your preferred services are configured. 1. Go to **Settings** > **Couriers** > **NZ Post Domestic** > **Settings**. 2. Click the **Advanced** tab. 3. Under **Default North Island Product** and **Default South Island Product,** select your preferred default products. If you want to use different products per order, choose the product on each order or configure rules to assign products automatically. For more information, see [Rules overview](/articles/notifications-branded-tracking-rules-child-accounts/business-rules/rules-overview). To customise the name or price of an NZ Post Domestic service, including its surcharges or package pricing, see [Customise NZ Post Domestic rates](/articles/15100000000020-customise-nz-post-domestic-rates). ## Optional features NZ Post Domestic also supports additional features such as returns and Oversize by Fliway. These are not required for the base NZ Post Domestic setup, but you can configure them if they are enabled on your NZ Post account. ### Returns with NZ Post Domestic NZ Post offers multiple returns services such as Economy Returns, Courier Returns, and Easy Returns. To enable NZ Post Domestic returns, contact your NZ Post account manager. You can also contact our [support team](https://help.starshipit.com) and we can help get the process underway. If you are not using Economy Returns or Courier Returns, NZ Post returns use the same product codes as outbound orders. To set the return code you would like to use: 1. Go to **Settings** > **Couriers** > **NZ Post Domestic** > **Advanced**. 2. Enter the code in the field **Return Label Code**. 3. Click **Save**. If you are using Economy Returns or Courier Returns, set up your returns address and default returns service in the NZ Post Domestic advanced settings. For help setting this up, contact our [support team](https://help.starshipit.com). ### Oversize by Fliway NZ Post Domestic also supports **Oversize by Fliway** for larger domestic consignments that are too large for standard courier services. This service is currently available through **Parcel Label API** and **eShip**. It is not available through **eCL Online**, **My NZ Post Business**, or prepaid labelling. Key points to know: * It is for New Zealand domestic freight only. * It supports items from **25 kg to 60 kg**. * Maximum dimensions are **3 m length**, **0.6 m3**, and **2.2 m height**. * Perishable goods, liquids, and dangerous goods are not supported. * The service is currently **non-signature only**. * When you create the label, NZ Post automatically books a pickup with Fliway. * Oversize items travel through the Fliway network and must be separated from your standard NZ Post freight. Contact your NZ Post business manager if you need Oversize by Fliway enabled on your account or want the relevant **FLWY** product code added. ## Troubleshooting #### Error message Could not authenticate comes up upon clicking the test This is most likely due to your account not having been fully set up yet. #### Error in getting access token The remote server returned an error: (401) Unauthorized. Please double-check your credentials and check for incorrect spacing. If it is still happening contact our [support team](https://help.starshipit.com). #### NZ Post not showing on the checkout If you have completed the set up in both courier configuration and in your eCommerce platform but NZ Post is still not showing as an option on your checkout, ensure you have **Print domestic Labels using API** enabled: * In Starshipit, go to **Settings** > **Couriers** > **NZ Post Domestic Settings** > **Advanced**. #### When uploading a logo to display logo on labels, I get an error "No logo uploaded" To upload a logo to NZ Post domestic labels, you must first: 1. In Starshipit, navigate to **Settings** > **Couriers** > **NZ Post Domestic Settings**. 2. Go to the **Advanced** tab and tick the **Print domestic Labels using API** option. 3. The Onboard-MerchantLogos API endpoint on Anypoint must be required and approved on your account. Please reach out to [our team](https://help.starshipit.com) to get this approved. ## Other relevant information for you To know more about NZ Post's eShip services, [click here](https://www.nzpost.co.nz/business/sending-within-nz/parcels/shipping-solutions-for-online-sellers/eship) For more information on NZ Post eShip and Starshipit, [click here](https://www.starshipit.com/blog-content/starshipit-v-eship-same-same-but-different) Starshipit supports Economy Returns and Courier Returns with NZ Post. For more information, contact our [support team](https://help.starshipit.com).