You first need to ensure you have a Professional seller account with Trade Me. 

If you have not a seller yet, you can apply HERE 

For more information on becoming a Professional Seller please review this article HERE 

Please review Trade Me's seller guide HERE 

This includes key information around:

• Payment Options
• Shipping and templates
• Our listing policies.
• Banned and restricted items.

Add the Trade Me Channel 

1. Log into your Marketplace Maximizer account.
2. Go to Channel from the left navigation.
3. Go to the Channels tab and Add Channels
4. Select Trade Me

Connect with Trade Me 

1. Under Trade Me via Channels, click on Sign In.
2. A popup will redirect you to Trade Me login. Enter your Seller credentials. 
3. Allow the authorization to integrate the Marketplace Maximizer app with your Trade Me seller account.
4. Once connected, the authorization status will display as "Connected." 

You can review Trade Me's API documentation HERE

To review how we connect into Trade Me follow the below steps:

• First ensure Trade Me has been added to your account.
• Login to Marketplace Maximizer.
• Go to Channels and Destination
• Click ?  next to Trade Me.
• Click on the API Docs tab.

This will show you all the APIs we connect into for each sync type.

What is NOT supported

• Order Cancellations (no TradeMe API)

• Customizing listing durations (not supported by API)

  • Products have a “Duration” attribute, however, it is ignored by the API and defaults to 7 days.

Products

• Default Payment Method - All products will be created with the payment options selected.
• Shipping Template - You will first need to create your shipping template following the instructions HERE. Once created, the template will be available for selection to apply across all products.
  • NOTE - This can be changed to have different templates via Rules.

Orders

• Support PayNow Refunds - Where you want to support refunds automatically using the Trade Me PayNow option.

An important step is to define what products you want to publish to Trade Me. This can be done via Products and Rules from the left navigation.

• Click Add Overwrite
• Select Trade Me
• Select Publish and Create Rule

Some common rules for Publishing include:

• Custom Field or Tag:

Depending on your eCommerce platform.

E.g., IF Tag / Custom Field = trademe, THEN publish = TRUE; ELSE FALSE. 

• Brand-based conditions: 

E.g., IF Brand = “MPM”, THEN publish = TRUE; ELSE FALSE. 

• SKU-based rules: 

E.g., IF SKU in ("XYZ123","ABC456"), THEN publish = TRUE; ELSE FALSE

• Keyword matching: 

E.g., IF Title contains “Eco-Friendly”, THEN publish = TRUE; ELSE FALSE

In order to create listings on Trade Me, the below mappings are required.

Category Mapping

• Go to Products and Mappings from the left navigation. 
• Match your source product categories with Trade Me’s category tree. 
• Repeat the process for all Source Categories. 

NOTE – You can bulk export / import via a spreadsheet. 

For more details on the mapping process please refer to this guide HERE

Category Attribute Mapping 

• Open the Category Attribute tab under the Trade Me channel.
• Map your store’s internal fields (e.g., brand) to Trade Me’s required attributes. 
• Use default values where attribute values are missing. 
• Pay special attention to required attributes that will show automatically upon category selection. 

NOTE – You can bulk export / import via a spreadsheet per attribute selected. 

For more details on the mapping process please refer to this guide HERE

Marketplace Maximizer  Rules Builder allows dynamic transformation of product data without modifying your Source catalogue. 

For more information on Rules, please review our guide HERE

Rule Types & Transformations 

Some common actions include: 

• Append / Prepend: Add fixed text to a field (e.g., prepend “New” to titles). 

• Search & Replace: Fix values (e.g., replace colour with color). 

• Add / Subtract: Adjust numeric values (e.g., increase price by 5%). 

• Overwrite: Set constant values (e.g., always use “New” for condition). 

Conditional Rules 

Apply rules only under specific conditions i.e. 

IF brand is empty 

THEN overwrite brand with “Generic” 

Preview Mode 

• Always use Preview before applying rules to ensure the has applied as expected and there are no errors. 

Rule Descriptions 

• Add notes to each rule for clarity and documentation. 

Example Use Cases: 

Rules are essential to ensuring Trade Me compliance and streamlined data output. 

For more information on Rules, please review our guide HERE

We recommend you approve a few products first, by following the below steps:

• Go to Products from the left navigation. 
• Select the product you wish to send to Trade Me. 
• Ensure required attributes are filled and category mapping are completed. 
• Click into the product and click Approve. You’ll see a response status for each product, to ensure there are no errors.

If you are happy with the few products you have Approved, you can bulk approve all products at a Marketplace level by following the below steps:

•  Go to Products and then Settings from the left navigation. 
• Under the Destination tab click Pending Approval next to Trade Me.
• This will confirm you want to approve all products to Trade Me. 

When Do We Create New Listings? 

New listings are created when: 

• Products are first published from Marketplace Maximizer to Trade Me. 

• Required data (title, description, SKU, category mapping, etc.) is present. 

When Do We Update Listings (e.g., Stock, Price)? 

Listings are updated in the following scenarios: 

• When stock, price, or product details change in Source. 

• On scheduled sync intervals or via manual update in the app. 

What happens when listings close? 

Once a listing closes, we check daily for all listings that have closed and

reactivate them automatically.  

NOTE - Listings will always have a duration of 7 days.

You can review the status of Trade Me by going to:

• Dashboard from the left navigation
• Selecting Product Health and Trade Me from the Dropdown
  • % of Successful Product listings.
  • % of Products with Errors.
    • A summary of error categories for you to click into to see the actions required to remove these errors.Dashboard summarizes:

There is also an Order Health Dashboard from the left navigation which will:

• Summary of orders by period.
• Summary of an order or order update errors.

• Description character limit

Description: 
Trade Me character limit for descriptions is 2000. 

Exact Error Message: ['["Please reduce your description by XX characters"]'] 

Action: 
Setup a rule to cut off the description at 2000 characters.

• Title character limit

Description: 
Trade Me character limit for title is 80. 

Exact Error Message: ['["Please reduce your title by XX characters"]'] 

Action: 
Setup a rule to cut off the title at 80 characters.