# Set up NZ Post International
URL: https://support.starshipit.com/articles/204485655-set-up-nz-post-international
Canonical: https://support.starshipit.com/articles/204485655-set-up-nz-post-international
Markdown: https://support.starshipit.com/articles/204485655-set-up-nz-post-international.md
Updated: 2026-10-08

> For the complete documentation index, see [llms.txt](https://support.starshipit.com/llms.txt).

> Step-by-step guide to setting up NZ Post international.

Connect a new NZ Post International account to Starshipit using your NZ Post account number. New connections can use Starshipit's shared API credentials, while existing connections keep their saved credentials.

## Before you begin

- Have an NZ Post International account number with access to the services you want to use.
- Have a Permit Post Number if your selected service requires one.
- If this NZ Post International connection already exists in Starshipit, keep its saved Client ID and Client Secret. Editing or saving it again does not switch it to shared credentials.

You do not need to request commercial API access.

## Connect NZ Post International

1. Go to **Settings** > **Couriers** > **Add New Courier** > **NZ Post International**.
2. Tick **Enable NZ Post International**.
3. Enter your **Account Number**. For a new connection using Starshipit's shared credentials, leave both **Client ID** and **Client Secret** empty. If you use your own NZ Post API credentials, enter both fields.
4. Enter a **Permit Post Number** if your selected service requires it, then set your **Default Export Type**.
5. Click **Save**.

If you enter only one of **Client ID** or **Client Secret**, Starshipit asks you to complete both fields. An existing connection cannot switch to shared credentials by removing its saved credentials.

## Add your product codes

Once Starshipit has confirmed NZ Post International is available on your account, you should check that your preferred services are available in the courier settings.

1. Go to **Settings** > **Couriers** > **NZ Post International** > **Settings**.
2. Select your new Product Code in the Drop-down menu.
3. Click **Add**.
4. Confirm the new product code appears in the list, then save your settings.

## Verify the connection

Use the courier settings to test the account, then confirm an eligible international service returns a rate and can create a label. If the test fails, check the account number, any required Permit Post Number, and whether both credential fields are complete when using your own credentials.

## Choose duties and VAT remittance for EU shipments

For NZ Post International accounts with EU PDDP enabled and the duty controls available, follow [Choose duties and VAT remittance for NZ Post EU shipments](/articles/1791494100001-choose-duties-and-vat-remittance-for-nz-post-eu-shipments). The available DAP and DDP choices depend on the current shipment and service. The courier's VAT remittance setting chooses who remits VAT when both DDP methods are offered; it does not enable DDP on every order.

## Returns

When you create a return from Australia to New Zealand, you’ll see eligible return services from Courier Select AU Returns (ICOUSRAUS) alongside EasyReturns.

## Use Photo Required

**Photo Required** asks NZ Post to capture a delivery photo when a parcel is left at the delivery address. It is available only when NZ Post offers it for the selected international service.

1. Open the order and select an NZ Post International service.
2. Check the delivery options for **Photo Required**.
3. Select **Photo Required** if it is available, then save or print the order.

Starshipit uses the option returned for that service and includes its charge in the quote. If you change to a service that does not offer Photo Required, the option is not available.

You can also use the existing **Photo Required (default option)** courier setting or **Set Photo Required** rule action. They apply only when the selected service supports the option. Photo Required cannot be used on a return label or together with **Signature Required**.
## Troubleshooting

#### Error: The test returns invalid accounts

Please carefully review the credentials you have entered and check for any possible errors or incorrect spaces. If you are still experiencing issues, please reach out to our [support team](https://help.starshipit.com) for further assistance.

## Configure NZ Post International settings

| Setting | What it does |
| --- | --- |
| Enable NZ Post International | Makes international NZ Post services available. Use NZ Post Domestic for domestic shipments. |
| Account Number, Client ID, and Client Secret | A new connection can use its Account Number with both credential fields empty. Existing connections continue to require their saved Client ID and Client Secret. |
| Default Export Type | Sets the customs export type, such as commercial sale, e-commerce goods, returned goods, gift, commercial sample, documents, or other. |
| DDP Tax Remittance Method / DDP remittance method | Chooses NZ Post-remitted or sender-remitted EU VAT when both methods are offered for an eligible NZ Post International DDP shipment. Defaults to NZ Post remitting VAT. Sender remittance requires a sender IOSS number. |
| Product codes | Add the international services enabled on your account. Product rows include code, name, type, default, maximum weight, cover, maximum cover, and label size. |
| Permit Post Number | Supplies a permit or post number for customs where required. |
| Customs Code/HS Code | Adds the default customs code to labels. |
| Apply Label fix to main services | Applies NZ Post's label correction to the main services. |
| Use generic item descriptions | Replaces individual item descriptions with the generic package description from **Settings > Defaults**. |
| Enable Easy Returns | Enables the Easy Returns product after NZ Post has enabled it on your commercial account. |
| Generate Customs Invoice for International Orders | Generates a customs invoice for international orders. |
| Sender ABN Number | Adds the sender's Australian Business Number to customs data. |
| Non-delivery action | Choose Return at sender's cost or Abandoned / Destroy. |
| Rotate label for selected products | Selects the product codes whose labels should be rotated. |
| Dangerous goods | Add the default, UN number, shipping name, class, packing group, package type, limited-quantity, radioactive, marine-pollutant, flashpoint, Hazchem, and additional-detail values for each DG entry. |