Skip to main content
New Zealand Post

Connect your NZ Post to your site for integrated courier functionality when fulfilling your orders

Callum McFadgen avatar
Written by Callum McFadgen
Updated over a month ago

Why should I connect a courier to my site?

If an order requires you to ship products to a customer then you may need to copy orders details into a courier application in order to select the correct service and create courier labels once you have fulfilled the order. This creates double handling that can be reduced by connecting a courier to your site.

Once a courier has been connected then additional functionality in the order fulfillment process allows you to validate shipping addresses, select courier rates and add-ons and create your courier labels, all thats left is to package up your orders, stick on the labels and request a pick up.

How does the connection between Airsquare and NZ Post work.

The connection between Airsquare and NZ Post is powered by APIs that allow different software applications like NZ Post and Airsquare to exchange information in a standardised way so that they can work seamlessly together.

How do I connect NZ Post to my site?

  1. Click here to create an account with NZ Post if you do not have one already.

  2. Once you have an account, click here to access NZ Posts register for commercial access online form.

  3. Under Developer contact, enter "Airsquare, "Support" and "support@airsquare.com" .

  4. Under What services do you want?, tick the Domestic and International option.

  5. Click the Submit button .

After submitting the form, you will receive an email from the NZ Post team within 2-3 business days. Once you have received the email, contact us at support@airsquare.com with the following information:

  • Your NZ Post username and password

  • Your NZ Post account number

  • Your NZ Post site code

  • Your NZ Post client ID

  • Your NZ Post client secret

This information will allow us to complete the more technical aspects of accessing and using these APIs on your behalf by creating a development portal and application for your buisness with the required APIs.

You will then receive another email from the NZ Post team requesting you to respond with your NZ Post account number and your NZ Post delivery address to confirm the API request.

After responding you will receive a final email from NZ Post to confirm that the APIs have been approved, you can then contact us at support@airsquare.com and we will test the APIs before connecting NZ Post to your site.

How do I know if NZ Post is connected?

  1. Go to Account > Connected Apps.

  2. Find NZ Post in the Couriers table.

  3. If NZ Post is connected the Status will be displayed as Connected.

How do I use NZ Post when fulfilling an order?

Can I select Pace couriers after connecting NZ Post?

No, currently Courier Post is the only NZ Post courier service supported by Airsquare.

What label size do I need for NZ Post?

Thermal (174mm x 100mm) for domestic labels
โ€‹
You can choose an International label size under Account > Connected Apps > NZ Post > Settings. This can be either Thermal (174mm x 100mm) or A4.
โ€‹

Did this answer your question?