# How to set up NZ Post Domestic URL: https://support.starshipit.com/articles/203806459-how-to-set-up-nz-post-domestic Canonical: https://support.starshipit.com/articles/203806459-how-to-set-up-nz-post-domestic Markdown: https://support.starshipit.com/articles/203806459-how-to-set-up-nz-post-domestic.md Updated: 2026-06-15 > 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. Request commercial access To use NZ Post with Starshipit, you must have commercial access to the NZ Post API. * **If you already have commercial access:** Please contact our [support team](https://help.starshipit.com). Our team will liaise with NZ Post on your behalf to request your respective API Key (Client ID) and API Secret (Client Secret). * **If you don't have commercial access:** Please get signed up with a NZ Post account, then tell us your NZ Post Account Number. We then use this to obtain your API credentials on your behalf. :::note The process to request commercial access only needs to be completed once if you are setting up all three services in Starshipit and using the same account number for all three. ::: ### 2. Enter your API details in Starshipit Usually, the Starshipit team will complete this setup for you. However, if you already have your API Key and API Secret and prefer to enter the details yourself: 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 Client ID (API Key) and Client Secret (API Secret). 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 configure advanced settings such as **Print domestic Labels using API**. ### 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). ## 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).