Logiwa + Shippo Integration User Guide

This guide walks you through integrating Shippo with Logiwa to streamline your shipping operations.

The Shippo integration connects Logiwa’s Warehouse Management System (WMS) with the Shippo multi-carrier shipping platform. This allows you to access shipping rates, purchase labels, and manage shipments from multiple carriers directly within Logiwa.


Before starting the integration, make sure you have:

  • An active Logiwa account
  • An active Shippo account
  • A Shippo API key

Integrate Shippo with Logiwa

Step 1: Log in to both platforms

Log in to both your:

  • Shippo account
  • Logiwa account

If you are not already logged into Shippo, you will be prompted to sign in or create an account.

 

Step 2: Gather integration credentials

In Logiwa, collect the required identifiers and credentials to enable the integration.

You will need the following:

  • ClientIdentifiers
  • WarehouseIdentifier
  • Your Logiwa API user account name
  • API key for the Shippo integration
  • API secret for the Shippo integration

These values are required to configure the integration between the two systems.

Step 3: Submit the activation request

Using the credentials gathered above:

  1. Compile the required JSON object
  2. Submit the configuration request to the Logiwa Integration Team
  3. The team will complete the final API configuration

Shippo Carrier Setup cURL


Connect Carrier Accounts in Shippo

Before shipping through Logiwa, you must connect your carrier accounts in Shippo.

Connect carriers in Shippo

  1. Log in to Shippo
  2. Click the Settings icon
  3. Select Carriers
  4. Click + Connect Carrier Account
  5. Select your carrier
  6. Enter the required carrier credentials
  7. Click Submit

Once connected, the carrier will appear under Your Accounts.

Watch Video Guide


Configure Shippo as a Custom Carrier in Logiwa

After the integration is activated, Shippo must be defined as a Custom Carrier in Logiwa.

This allows Logiwa to communicate with Shippo for shipping services.

Create a Custom Carrier

  1. Navigate to Settings → Configuration → Data Setup
  2. In the left sidebar, select Custom Carrier

  1. Click Create New

  Note: You can also Update or Delete an existing custom carriers from the same screen.

 

  1. The Create Custom Carrier sidebar will open
  2. In the General section, enter:
  • Carrier Code (Shippo carrier account ID)
  • Carrier Name (example: SHIPPO)

The code and name can be identical if preferred.

  1. Click Next to continue in the Services section/

Define Custom Carrier Details

Within the Custom Carrier setup:

General

Enter:

  • Carrier Code
  • Carrier Name

Services

Add the services you plan to use.

Examples:

  • Ground
  • Priority Mail

Package Types

Add package types such as:

  • Box
  • Letters

Once finished, click on the Advance section.

Configure Advanced Settings

Configure optional carrier features as needed.

Insurance Types

Define available insurance types.

Billing Types

Specify supported billing methods.

Third-Party Accounts

Add third-party billing account numbers, including:

  • Account number
  • Country
  • ZIP code

After entering the required information, click Save.

Your custom carrier will now appear in the Custom Carrier list.


Using Shippo for Rate Shopping and Label Creation

Once Shippo is configured, you can use it for rate shopping and label creation directly within Logiwa fulfillment workflows.

Set Up Rate Shopping

You must create a Rate Shopping Preset that includes Shippo services.

  1. Navigate to Settings → Configuration → Rate Shopping Presets
  2. Create or edit a preset.
  3. In the Settings tab, choose a Rate Calculation Method:

Examples:

  • Cheapest
  • Fastest
     
  1. In the Shipment Methods tab:
  • Locate your Shippo Custom Carrier
  • Enable all services configured earlier.

Running Rate Shopping

When packing an order:

  1. In the Packing Station, pack the order.
  2. Make a selection for Carrier.

  1. Make a selection for Shipping Service (for example: Cheapest Shippo).
  2. Click Change to view additional carrier rates returned by Shippo.
  3. Select the preferred shipping option.

To purchase the label:

  • Click Complete Packing and Create Label, or
  • Click Get Label from the Order Backlog.

  Note: You can change the selected rate at any time using the Change button.

Create an Instant Label

After retrieving rates or selecting a carrier and service level:

  1. Choose the desired rate
  2. Click Create Label
  3. Shippo will generate the shipping label directly through the integration.


Third-Party Billing Setup

To enable third-party billing:

  1. Navigate to Integrations → Shipping
  2. Go to Integration Management → Customer Carrier

  1. Select Shippo under Custom Carrier integrations

  1. Create the shipping integration
  2. In Advanced Settings, add the third-party account
  3. Click Save.


Configuring Shipment Insurance

Shipment insurance can be configured:

  • Automatically through Workflows, or
  • Manually during the Batch Label process.

Workflow Automation (Recommended)

To configure automated insurance:

  1. Create an Insurance Type in the Custom Carrier Advanced settings.

  1. Navigate to Automation → Workflows & Algorithms → Workflows

  1. Create a new workflow using the Set Shipment Instructions Update Action.

  1. Configure the action:
  • Carrier setup: Shippo
  • Insurance type
  • Insurance value (%)

This ensures consistent insurance values across shipments.

 

Batch Label Process (Manual Override)

To manually configure insurance:

  1. In the Order Backlog, select an order.
  2. Click Create Label.

  1. Open Advanced Settings.

  1. Select the Insurance Type.
  2. Enter the Insured Value.
  3. Click Get Label.

More details about Shippo Total Protection Insurance


Handling Hazardous Materials (Hazmat)

Logiwa maps the following hazard properties to Shippo:

  • Hazardous
  • Lithium
  • Biological

These properties determine how items are classified during shipping.

 

Configure hazardous materials

  1. Navigate to Settings → Products
  2. Open the product.
  3. Go to the Advanced tab.
  4. Enable Mark this item as hazardous
  5. Select the appropriate Hazmat Type (for example: BATTERY).


Returns

Logiwa does not natively support return label creation.

To generate a return label:

  1. Log in to your Shippo account
  2. Follow Shippo’s Return Label Guide here.

Billing

All billing related to Shippo services—including shipping labels and subscription fees—is handled directly by Shippo, not Logiwa.

You will be billed based on your monthly shipping volume. Plans currently start at $19/month. For full details, see our pricing here: Shippo Subscription Plan Overview

There are no additional charges from Logiwa to use the Shippo integration.

To access billing in Shippo:

  1. Log in to the Shippo App
  2. Navigate to Settings → Account → Billing

From there you can:

  • Download invoices
  • Update payment methods
  • View pending transactions


Troubleshooting

Issue Shippo Response Logiwa Action
Invalid address 400 Bad Request with validation details Display: “Invalid address provided. Please check and try again.”
Authentication failure 401 Unauthorized Display: “Authentication with carrier failed.”
Insufficient funds 402 Payment Required Display: “Carrier account has insufficient funds to purchase the label.”
Invalid request data 400 Bad Request with field errors Display a message such as “Missing package weight.”
API timeout No response within 30 seconds Display: “The shipping carrier did not respond in time. Please try again later.”

 

Was this article helpful?

Related articles