ParcelLabel API

The ParcelLabel API is used to create parcel and destination specific shipping labels.

Pre-requisites

In order for you to gain access to the APIs, you and your organisation must meet the following pre-requisites:

1. Your organisation must have an active NZPost or CourierPost account number.
2. You must be registered with the Developer Portal. You can register here by completing the registration form. The email address you provide on the registration form will be your Developer Portal username.
3. You must have reviewed and accepted the Terms and Conditions for use of the NZPost APIs.
4. You must have requested and received access to the API.
5. If you require international labeling from this API, please ​specify this requirement to api@nzpost.co.nz. This product needs us to perform a different technical setup behind the scenes to get international labeling working for you. Please ensure you have the international products of your choice set up with your NZ Post account manager.
6. You may apply to use a logo for your company to be incorporated onto your CourierPost and Pace shipping labels. Provided logos must be 1480 pixels wide by 380 pixels high and in png format. Upon confirmation of receipt and acceptance of the label size and format, you will be provided with a logo id. CourierPost and Pace label requests that include a valid logo id will be created with the logo in place. Logos will be considered in accordance with the logo rules described on the Operational Considerations page.

Support

For enquiries regarding how to consume this api, please email api@nzpost.co.nz. Support is available during New Zealand business hours.