# 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-20

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

> Connect NZ Post International or switch an existing connection to shared API credentials while keeping your account and services.

Connect NZ Post International using your NZ Post account number and Starshipit's shared API credentials. You can also choose to switch an existing connection from your own credentials without deleting it or changing your services.

## 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 you want to keep using your own NZ Post API credentials, have both your Client ID and Client Secret. Saving a connection with those credentials still entered keeps it on your own credentials.

You do not need to request commercial API access.

## Connect NZ Post International

1. Go to **Settings > Couriers > Add a new courier > NZ Post International**. In UI 2.0, open **[Add a new courier](https://next.starshipit.com/settings/couriers/add)**.
2. Tick **Enable NZ Post International**.
3. Enter your **Account Number**. Leave both **Client ID** and **Client Secret** empty to use Starshipit's shared credentials, or enter both fields to use your own NZ Post API credentials.
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 credential, Starshipit asks you to complete both fields. Shared credentials require a valid **Account Number**.

## Switch an existing connection to shared credentials

Use this procedure in Classic UI or UI 2.0 when you want to stop using your own API credentials. You do not need to delete and recreate the connection.

1. Open **Settings > Couriers > NZ Post International**. In UI 2.0, open **[NZ Post International settings](https://next.starshipit.com/settings/couriers/setup/nz-post-international)**.
2. Check your **Account Number**, product codes and default service before changing the credentials.
3. Clear both **Client ID** and **Client Secret**. Clearing only one is rejected.
4. Click **Save**.
5. Reopen the settings and confirm both credential fields remain empty and your account number, product codes and default service are unchanged.
6. Check an eligible international order to confirm your expected service returns a rate.

Leaving your own credentials entered continues to use them; saving other settings does not switch the connection automatically. Shared credentials do not add services to your NZ Post account.

## Add your product codes

Add the international services available on your NZ Post account.

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

Save and reopen the courier settings, then test the account and check an eligible international order. Confirm the expected service returns a rate before creating its label. If the test fails, check the account number, any required Permit Post Number, and whether the credential fields are either both empty or both complete.

## 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

If the account test reports invalid accounts or an authentication error, check the saved account number and remove unintended spaces. For your own credentials, enter both fields; for shared credentials, clear both fields and save before testing again. Contact [Support](/ticket) if the error persists. Keep API secrets out of the ticket description.

## 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 | New and existing connections can use shared credentials with both credential fields empty. Enter both fields to use your own credentials. Saving other settings leaves your credential choice unchanged. |
| 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. |