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

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.

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

Was this article helpful?
0 out of 1 found this helpful



Please sign in to leave a comment.