# Set up SEKO
URL: https://support.starshipit.com/articles/360000206496-set-up-seko
Canonical: https://support.starshipit.com/articles/360000206496-set-up-seko
Markdown: https://support.starshipit.com/articles/360000206496-set-up-seko.md
Updated: 2026-10-10

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

> Connect SEKO to Starshipit, configure delivery options and send an applicable New Zealand GST registration with shipments.

Connect SEKO to Starshipit with your API key, configure the delivery options for your account, and verify a shipment before you start shipping.

## Before you begin

Have your SEKO account number and API key ready. To request an API key, submit a ticket to [SEKO Logistics Support](https://seko.atlassian.net/servicedesk/customer/portal/31/group/95), select **OmniParcel**, and include your account number. Keep the key private.

## Connect SEKO

1. In Starshipit, go to **Settings > Couriers > Add a new courier > SEKO**.
2. Select **Enable SEKO**.
3. Enter the API key supplied by SEKO in **Access Key**.
4. Click **Save**.

Starshipit retrieves available product codes from SEKO when required. You do not need to enter them manually. You can still use rules to assign default products.

## Configure SEKO settings

| Setting | What it does |
| --- | --- |
| **Enable SEKO** | Turns the SEKO connection on. |
| **Access Key** | Authenticates requests to SEKO. |
| **Signature Required** | Requests a signature as a default delivery option. |
| **Generate commercial invoice with label** | Generates the commercial invoice together with the label. |
| **Sender Pays Duty** | Sets the sender as responsible for duties. |
| **Send tracking emails (Seko notifications)** | Requests SEKO tracking notifications. |
| **Specify the service name on print** | Prints the service name. If off, SEKO selects the cheapest service for the destination. |
| **Label Format** | Selects PDF 100 x 150, PDF 100 x 200, or PDF A4. |
| **Display SKU on labels** | Prints SKUs on SEKO labels. |
| **Product codes** | SEKO retrieves available product codes from its systems when required. You do not need to enter them manually. |

Save any changes before creating a shipment. Confirm the options and services available on your SEKO account.

## Add GST for shipments to New Zealand

When SEKO requires your New Zealand GST registration for the shipment, add it as a shipper tax number in Starshipit. Use **GST** as the tax type.

1. Go to **Settings > Options > Shipper Tax Settings**.
2. Click **Add New**.
3. Select **GST - GST Registration** as the **Tax Type**.
4. Enter your **Tax Number** and select New Zealand as the **Applicable Destination**.
5. Click **Add**.

Check the saved type, number and destination. Starshipit sends the applicable GST registration to SEKO with the shipment's tax information. See [Set up shipper tax numbers](/articles/360002115215-set-up-shipper-tax-numbers) for destination defaults and tax-number rules.

## Verify the setup

1. Create or open a test order for a service enabled on your SEKO account.
2. Check the destination, items, delivery options and any required tax registration.
3. Print the label and check the returned label and tracking number.
4. For a New Zealand shipment requiring GST, confirm SEKO accepts the tax information. Check the customs documents where the number is displayed, or contact Starshipit support if you cannot confirm which number was sent.

If a shipment is rejected, check the error, your saved API key, the selected service and the applicable shipper tax number before trying again.

## Related articles

- [Set up shipper tax numbers](/articles/360002115215-set-up-shipper-tax-numbers)