# How to set up Mainfreight 2Home
URL: https://support.starshipit.com/articles/10506622692239-how-to-set-up-mainfreight-2home
Canonical: https://support.starshipit.com/articles/10506622692239-how-to-set-up-mainfreight-2home
Markdown: https://support.starshipit.com/articles/10506622692239-how-to-set-up-mainfreight-2home.md
Updated: 2026-02-05

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

> Step-by-step guide to setting up Mainfreight 2Home.

Starshipit is now integrated with [Mainfreight](https://starshipit.com/partner/mainfreight-shipping) 2Home in New Zealand. With Mainfreight 2Home, you can deliver directly to your customer’s door. This service is the ideal solution for delivering medium to large items to homes or businesses. It’s perfect for:

* Retail businesses delivering to homes
* Online retailers shipping from their warehouse
* Distributors
* Individuals with one-off goods to move

Mainfreight 2Home is available as a domestic courier option when shipping from New Zealand.

## Before you begin

To integrate Mainfreight 2Home with your Starshipit account, you’ll need a Mainfreight account. If you don’t have one, please get in touch with your Mainfreight account manager. To complete the setup, you will need the following information issued by Mainfreight:

* Your Mainfreight Account Code
* Your Housebill

**Prefix Registration**  
The alpha prefix must be registered with Mainfreight in advance. If you did not receive it during your onboarding with Mainfreight, please get in touch with your Mainfreight account manager to obtain your registered prefix.

**Housebill Format**  
The Housebill requires an alpha prefix followed by numeric characters.

* The alpha prefix must be between 2 to 4 characters.
* The numerical section must be at least 3 and no more than 12 characters.
* The total length of the Housebill, including the prefix, must not exceed 14 characters.

Here are some examples of Housebill formats:

#### Valid ✅

The numeric section following the prefix (e.g. ABC) must start and end with a one for a valid format.

* ABC101  
  The alpha prefix is 3 characters, the numerical section is 3 characters and starts/ends with a one.
* AB1001  
  The alpha prefix is 2 characters, the numerical section is 4 characters and starts/ends with a one.

#### Invalid ❌

The numeric section following the prefix (e.g. ABC) must not start with zero for a valid format.

* **A**2**B**389939  
  The alpha prefix is only 1 character and an invalid alpha value follows the 2.
* 1272829**BC**  
  The alpha prefix should be at the front of the Housebill.
* ABC**0**00001  
  The alpha prefix is 3 characters which is valid, however, the numerical section starts with zero, making this invalid.
* ABCD10000000001  
  The alpha prefix is 4 characters, the numerical section is 11 characters and starts/ends with a one which is valid, however, the total length of the Housebill exceeds 14 characters, making this invalid.

:::note
In order to secure these details, please reach out to your Mainfreight 2Home Account Manager, or M2HomeAklSales@mainfreight.com.
:::

## Setting up your Mainfreight 2Home account in Starshipit

1. In Starshipit, navigate to **Settings** > **Couriers** > **Add a new courier.**
2. Set the shipping country as **New Zealand**.
3. Select **Mainfreight** in the list of couriers.
4. Tick the **Enabled** box.
5. Enter your Mainfreight **Account Code** and **Housebill**.
6. Click **Save**.

![Mainfreight carrier settings.gif](/uploads/articles/couriers/mainfreight-2home/how-to-set-up-mainfreight-2home/image_10748983041679.png)

## Add your product codes

Finally, add the product codes you’d like to use for Mainfreight:

1. In the same Mainfreight settings page from above, scroll down to the **Add product codes** section.
2. Select a product code (e.g. M2H) from the **Add New Product Code** list.
3. Click **Add** to save the product code.  
4. To designate a product code as your default, tick the **Default** checkbox.

## Other relevant information

You can learn more about Mainfreight2Home shipping services [here](https://www.mainfreight.com/new-zealand/en-nz/services-nz/transport/home-delivery).