How to set up CourierPost

NZ Post offers a range of services across New Zealand, including NZ Post (International), CourierPost (domestic) and Pace (same-day domestic delivery service).

NZ Post’s integration with Starshipit allows you to use all of Starshipit's features including generation of packing slips and shipping labels, auto-correction of addresses, branded tracking and notifications and many more.

This article outlines how to set up CourierPost as a courier service in Starshipit.

Note: The CourierPost integration includes the domestic services only, for International you need to set up NZ Post.

N.B You can use your existing NZ Post API credentials for CourierPost, you do not need to generate new ones.

N.B An account number starting with a 9 can be used for Domestic and International. An account number starting with a 5 can only be used for International.

Setting up your CourierPost account in Starshipit

1. Request your API key for the NZ Post / CourierPost API

Before you can integrate CourierPost, you will need to apply for commercial access with NZ Post and have the Starshipit team request your API credentials from NZ Post. If you wish to use NZ Post international as well as CourierPost, you can apply for both through the same application.

Follow the steps in this article get your NZ Post and/or CourierPost setup

2. Troubleshooting

Q. When I click test I get: Could not authenticate.

A. Most likely your account has not been setup yet.

Error message is: Error in getting access token:

The remote server returned an error: (401) Unauthorized.

Double check your credentials, checking for incorrect spacing, if it's still happening contact support on


Other relevant information for you:

  • To know more about CourierPost services by NZPost, click here
  • For information on Starshipit's association with NZPost's eShip services, click here
Was this article helpful?
0 out of 1 found this helpful



Please sign in to leave a comment.