Applying for access to the Shipping APIs is a simple three step process.
Step 1. Register for a https://www.nzpost.co.nz account
If you don't already have one, you will need to register for a NZ Post Online Account. You will be prompted to enter some user information, an email address, and a password. Note that the email address you provide in the registration process will by your username when logging into the Developer Portal. You can do this by navigating to the following URL:
Step 2. Complete the commercial access form
This form provides us with the required billing information which is attached to your API key. This form only needs to be filled out once for your organization and must be completed in order for us to approve your application:
Step 3. Request API access for an application
(Please note that you will need to repeat this step for each API you're wanting access to)
Navigate to the technical documentation for the API you're wanting to access. You can find links to our technical documentation on the following page (simply click on the name of the API you're after):
At the top of the technical documentation page, click the "Request API access" button:
1. Select one of your existing applications (if you have already requested access for other APIs) or
2. Add a “new application”.
When registering a new application, include OAuth 2.0 grant type "Client Credentials Grant".
Select the SLA tier you would like to use.
Read the Terms & Conditions and check the box to accept these.
Hit request access.
Your access request will be assessed and approved within 2-3 working days. You will receive an e-mail upon approval.
If you require access to our UAT environment, please get in touch with our support team at email@example.com. Make sure you provide us with the name of your application.
Retrieving your client_id/client_secret
You can retrieve your client_id/client_secret by navigating to the following page, these keys are used for accessing our APIs:
From here, simply click on the name of your application: