Skip to content

Instance · Ecommerce

Creating a Freight Supplier

Last updated 1 November 2026

Add a carrier you ship with, with its methods, service options and tracking link.

A freight supplier is a carrier you ship orders with. Once you add one, you can choose it on an order's shipping and give the customer its tracking link. Add each carrier you use, with the methods and service options it offers.

Create a freight supplier

  1. In the admin, open Ecommerce and choose Freight Suppliers.
  2. Select Create Freight Supplier.
  3. Fill in the form.
  4. Select Create Freight Supplier to save.

The form

FieldTypeRequiredMeaning
Freight Supplier NameTextYesThe name of the carrier
Freight MethodsA list of entriesNoHow it ships, for example road or air
Freight OptionsA list of entriesNoIts service levels, for example standard or express
Tracking LinkTextNoThe address customers use to track a parcel

Note

These steps follow the module source and the Insites Logic Engine reference. They were not carried out on the docs instance, because they change data.

From code

The Ecommerce API creates the same record. Only the name is required:

POST /ecommerce/api/v2/freight-suppliers

{
  "freight_supplier_name": "Example Freight",
  "freight_methods": ["Road", "Air"],
  "freight_options": ["Standard", "Express"],
  "tracking_link": "https://example.com/track"
}

Send the raw instance API key in the Authorization header, with no Bearer prefix.

Common mistakes

  • Leaving out the tracking link. Customers then cannot follow their parcel.
  • Using the deprecated tracking_code and status fields on a supplier. Put the tracking code on the order's shipping package instead.
  • Creating a new supplier for each service level. Add the levels as freight options on one supplier.